Halaman ini diterjemahkan oleh Cloud Translation API.

Class DataSourcePivotTable

Mengakses dan mengubah tabel pivot sumber data yang ada. Untuk membuat tabel pivot sumber data baru, gunakan Range.createDataSourcePivotTable(dataSource).

Hanya gunakan class ini dengan data yang terhubung ke database.

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`addColumnGroup(columnName)`	`PivotGroup`	Menambahkan grup kolom pivot baru berdasarkan kolom sumber data yang ditentukan.
`addFilter(columnName, filterCriteria)`	`PivotFilter`	Menambahkan filter baru berdasarkan kolom sumber data yang ditentukan dengan kriteria filter yang ditentukan.
`addPivotValue(columnName)`	`PivotValue`	Menambahkan nilai pivot baru berdasarkan kolom sumber data yang ditentukan tanpa meringkas apa pun fungsi tersebut.
`addPivotValue(columnName, summarizeFunction)`	`PivotValue`	Menambahkan nilai pivot baru berdasarkan kolom sumber data yang ditentukan dengan fungsi summarize yang ditentukan fungsi tersebut.
`addRowGroup(columnName)`	`PivotGroup`	Menambahkan grup baris pivot baru berdasarkan kolom sumber data yang ditentukan.
`asPivotTable()`	`PivotTable`	Menampilkan tabel pivot sumber data sebagai objek tabel pivot reguler.
`cancelDataRefresh()`	`DataSourcePivotTable`	Membatalkan pemuatan ulang data yang terkait dengan objek ini jika objek sedang berjalan.
`forceRefreshData()`	`DataSourcePivotTable`	Memuat ulang data objek ini terlepas dari status saat ini.
`getDataSource()`	`DataSource`	Mendapatkan sumber data yang ditautkan ke objek.
`getStatus()`	`DataExecutionStatus`	Mendapatkan status eksekusi data objek.
`refreshData()`	`DataSourcePivotTable`	Memuat ulang data objek.
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	Menunggu hingga eksekusi saat ini selesai, waktu habis setelah jumlah detik yang diberikan.

Dokumentasi mendetail

`addColumnGroup(columnName)`

Menambahkan grup kolom pivot baru berdasarkan kolom sumber data yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
`columnName`	`String`	Nama kolom sumber data yang menjadi dasar grup pivot.

Pulang pergi

PivotGroup — Grup pivot baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addFilter(columnName, filterCriteria)`

Menambahkan filter baru berdasarkan kolom sumber data yang ditentukan dengan kriteria filter yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
`columnName`	`String`	Nama kolom sumber data yang menjadi dasar filter.
`filterCriteria`	`FilterCriteria`	Kriteria yang digunakan filter.

Pulang pergi

PivotFilter — Filter baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addPivotValue(columnName)`

Menambahkan nilai pivot baru berdasarkan kolom sumber data yang ditentukan tanpa fungsi ringkasan. Hanya untuk pengukuran Looker.

Kode berikut menunjukkan cara menambahkan ukuran Looker sebagai nilai pivot.

// TODO(developer): Replace with your spreadsheet ID which has a Looker data source.
var spreadsheet = SpreadsheetApp.openById("abcd1234")
var datasource = spreadsheet.getDataSources()[0];
var pivotTable = datasource.createDataSourcePivotTableOnNewSheet();

pivotTable.addPivotValue("columnName");

Metode ini hanya tersedia untuk sumber data Looker.

Parameter

Nama	Jenis	Deskripsi
`columnName`	`String`	Nama kolom sumber data yang menjadi dasar nilai pivot.

Pulang pergi

PivotValue — Nilai pivot baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addPivotValue(columnName, summarizeFunction)`

Menambahkan nilai pivot baru berdasarkan kolom sumber data yang ditentukan dengan fungsi summarize yang ditentukan fungsi tersebut.

Guna menambahkan nilai pivot untuk ukuran Looker, gunakan addPivotValue(columnName).

Parameter

Nama	Jenis	Deskripsi
`columnName`	`String`	Nama kolom sumber data yang menjadi dasar nilai pivot.
`summarizeFunction`	`PivotTableSummarizeFunction`	Fungsi summarize yang digunakan oleh nilai pivot.

Pulang pergi

PivotValue — Nilai pivot baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addRowGroup(columnName)`

Menambahkan grup baris pivot baru berdasarkan kolom sumber data yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
`columnName`	`String`	Nama kolom sumber data yang menjadi dasar grup pivot.

Pulang pergi

PivotGroup — Grup pivot baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`asPivotTable()`

Menampilkan tabel pivot sumber data sebagai objek tabel pivot reguler.

Pulang pergi

PivotTable — Tabel pivot.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`cancelDataRefresh()`

Membatalkan pemuatan ulang data yang terkait dengan objek ini jika objek sedang berjalan.

Contoh ini menunjukkan cara membatalkan pembaruan formula.

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Gunakan metode SpreadsheetApp#enable...Execution() untuk mengaktifkan eksekusi data untuk jenis sumber data tertentu.

Pulang pergi

DataSourcePivotTable — Objek data.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`forceRefreshData()`

Memuat ulang data objek ini terlepas dari status saat ini. Lihat refreshData() untuk secara lebih mendetail. Jika Anda ingin membatalkan pemuatan ulang objek ini yang sedang berjalan, lihat cancelDataRefresh().

Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Menggunakan metode SpreadsheetApp#enable...Execution() untuk mengaktifkan eksekusi data bagi sumber data tertentu .

Pulang pergi

DataSourcePivotTable — Objek data.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSource()`

Mendapatkan sumber data yang ditautkan ke objek.

Pulang pergi

DataSource — Sumber data.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getStatus()`

Mendapatkan status eksekusi data objek.

Pulang pergi

DataExecutionStatus — Status eksekusi data.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`refreshData()`

Memuat ulang data objek.

Menampilkan pengecualian jika saat ini dalam status error. Gunakan DataSource#updateSpec() untuk memperbarui spesifikasi. Metodenya adalah lebih disukai daripada forceRefreshData() untuk mencegah pengeditan yang tidak terduga pada sumber data.

Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Menggunakan metode SpreadsheetApp#enable...Execution() untuk mengaktifkan eksekusi data bagi sumber data tertentu .

Pulang pergi

DataSourcePivotTable — Objek data.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`waitForCompletion(timeoutInSeconds)`

Menunggu hingga eksekusi saat ini selesai, waktu tunggu habis setelah jumlah detik yang diberikan. Menampilkan pengecualian jika eksekusi tidak selesai saat waktu habis, tetapi tidak membatalkan dalam eksekusi data.

Parameter

Nama	Jenis	Deskripsi
`timeoutInSeconds`	`Integer`	Waktu tunggu untuk eksekusi data, dalam detik. Maksimumnya adalah 300 detik.

Pulang pergi

DataExecutionStatus — Status eksekusi data.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets