Class DataSourcePivotTable

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

MetodeJenis nilai yang ditampilkanDeskripsi singkat
addColumnGroup(columnName)PivotGroupMenambahkan grup kolom pivot baru berdasarkan kolom sumber data yang ditentukan.
addFilter(columnName, filterCriteria)PivotFilterMenambahkan filter baru berdasarkan kolom sumber data yang ditentukan dengan kriteria filter yang ditentukan.
addPivotValue(columnName)PivotValueMenambahkan nilai pivot baru berdasarkan kolom sumber data yang ditentukan tanpa fungsi ringkasan.
addPivotValue(columnName, summarizeFunction)PivotValueMenambahkan nilai pivot baru berdasarkan kolom sumber data yang ditentukan dengan fungsi ringkas yang ditentukan.
addRowGroup(columnName)PivotGroupMenambahkan grup baris pivot baru berdasarkan kolom sumber data yang ditentukan.
asPivotTable()PivotTableMenampilkan tabel pivot sumber data sebagai objek tabel pivot biasa.
cancelDataRefresh()DataSourcePivotTableMembatalkan refresh data yang terkait dengan objek ini jika saat ini sedang berjalan.
forceRefreshData()DataSourcePivotTableMemuat ulang data objek ini, terlepas dari status saat ini.
getDataSource()DataSourceMendapatkan sumber data yang ditautkan ke objek.
getStatus()DataExecutionStatusMendapatkan status eksekusi data objek.
refreshData()DataSourcePivotTableMemperbarui data objek.
waitForCompletion(timeoutInSeconds)DataExecutionStatusMenunggu hingga eksekusi saat ini selesai, dengan waktu tunggu habis setelah jumlah detik yang diberikan.

Dokumentasi mendetail

addColumnGroup(columnName)

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

Parameter

NamaJenisDeskripsi
columnNameStringNama 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

NamaJenisDeskripsi
columnNameStringNama kolom sumber data yang menjadi dasar filter.
filterCriteriaFilterCriteriaKriteria 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 ukuran Looker.

Kode berikut menunjukkan cara menambahkan ukuran Looker sebagai nilai pivot. 

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

pivotTable.addPivotValue('columnName');

Metode ini hanya tersedia untuk sumber data Looker.

Parameter

NamaJenisDeskripsi
columnNameStringNama 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 ringkas yang ditentukan.

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

Parameter

NamaJenisDeskripsi
columnNameStringNama kolom sumber data yang menjadi dasar nilai pivot.
summarizeFunctionPivotTableSummarizeFunctionFungsi ringkasan yang digunakan 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

NamaJenisDeskripsi
columnNameStringNama 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 biasa.

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 refresh data yang terkait dengan objek ini jika saat ini sedang berjalan.

Contoh ini menunjukkan cara membatalkan refresh 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 bagi 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 detail selengkapnya. Jika Anda ingin membatalkan penyegaran objek ini yang sedang berjalan, lihat cancelDataRefresh().

Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Gunakan metode SpreadsheetApp#enable...Execution() untuk mengaktifkan eksekusi data bagi 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

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()

Memperbarui data objek.

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

Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Gunakan metode SpreadsheetApp#enable...Execution() untuk mengaktifkan eksekusi data bagi 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

waitForCompletion(timeoutInSeconds)

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

Parameter

NamaJenisDeskripsi
timeoutInSecondsIntegerWaktu untuk menunggu eksekusi data, dalam detik. Maksimum 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