Class DataSource

SumberData

Mengakses dan mengubah sumber data yang ada. Untuk membuat tabel sumber data dengan sumber data baru, lihat DataSourceTable.

Hanya gunakan class ini dengan data yang terhubung ke database.

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
cancelAllLinkedDataSourceObjectRefreshes()	void	Membatalkan semua pembaruan objek sumber data yang sedang berjalan dan ditautkan ke sumber data ini.
createCalculatedColumn(name, formula)	DataSourceColumn	Membuat kolom yang dihitung.
createDataSourcePivotTableOnNewSheet()	DataSourcePivotTable	Membuat tabel pivot sumber data dari sumber data ini di sel pertama sheet baru.
createDataSourceTableOnNewSheet()	DataSourceTable	Membuat tabel sumber data dari sumber data ini di sel pertama sheet baru.
getCalculatedColumnByName(columnName)	DataSourceColumn	Menampilkan kolom yang dihitung di sumber data yang cocok dengan nama kolom.
getCalculatedColumns()	DataSourceColumn[]	Menampilkan semua kolom yang dihitung di sumber data.
getColumns()	DataSourceColumn[]	Menampilkan semua kolom di sumber data.
getDataSourceSheets()	DataSourceSheet[]	Menampilkan sheet sumber data yang terkait dengan sumber data ini.
getSpec()	DataSourceSpec	Mendapatkan spesifikasi sumber data.
refreshAllLinkedDataSourceObjects()	void	Memuat ulang semua objek sumber data yang ditautkan ke sumber data.
updateSpec(spec)	DataSource	Memperbarui spesifikasi sumber data dan memuat ulang objek sumber data yang ditautkan dengan sumber data ini dengan spesifikasi baru.
updateSpec(spec, refreshAllLinkedObjects)	DataSource	Memperbarui spesifikasi sumber data dan memuat ulang data source sheets tertaut dengan spesifikasi baru.
waitForAllDataExecutionsCompletion(timeoutInSeconds)	void	Menunggu hingga semua eksekusi saat ini dari objek sumber data tertaut selesai, waktu tunggu akan habis setelah jumlah detik yang diberikan.

Dokumentasi mendetail

cancelAllLinkedDataSourceObjectRefreshes()

Membatalkan semua pembaruan objek sumber data yang sedang berjalan dan ditautkan ke sumber data ini.

Contoh ini menunjukkan cara membatalkan semua pembaruan sumber data.

SpreadsheetApp.enableBigQueryExecution();
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const dataSource = spreadsheet.getDataSources()[0];
dataSource.cancelAllLinkedDataSourceObjectRefreshes();

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

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

---

createCalculatedColumn(name, formula)

Membuat kolom yang dihitung. Metode ini hanya tersedia untuk sumber data BigQuery.

Parameter

Nama	Jenis	Deskripsi
name	String	Nama kolom yang dihitung.
formula	String	Formula kolom yang dihitung.

Pulang pergi

DataSourceColumn — Kolom kalkulasi yang baru dibuat.

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

---

createDataSourcePivotTableOnNewSheet()

Membuat tabel pivot sumber data dari sumber data ini di sel pertama sheet baru. Sebagai efek samping, sheet baru akan menjadi sheet aktif.

Pulang pergi

DataSourcePivotTable — Tabel pivot sumber data yang baru dibuat.

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

---

createDataSourceTableOnNewSheet()

Membuat tabel sumber data dari sumber data ini di sel pertama sheet baru. Sebagai efek samping, sheet baru akan menjadi sheet aktif.

Metode ini hanya tersedia untuk sumber data BigQuery.

Pulang pergi

DataSourceTable — Tabel sumber data yang baru dibuat.

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

---

getCalculatedColumnByName(columnName)

Menampilkan kolom yang dihitung di sumber data yang cocok dengan nama kolom.

Parameter

Nama	Jenis	Deskripsi
columnName	String	Nama kolom kalkulasi yang akan didapatkan.

Pulang pergi

DataSourceColumn — Kolom yang dihitung yang cocok dengan nama kolom, atau null jika tidak ada kolom yang dihitung tersebut.

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

---

getCalculatedColumns()

Menampilkan semua kolom yang dihitung di sumber data.

Spesifikasi sumber data jenis DataSourceType.LOOKER menampilkan array kosong.

Pulang pergi

DataSourceColumn[] — Array dari semua kolom kalkulasi di 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

---

getColumns()

Menampilkan semua kolom di sumber data.

Pulang pergi

DataSourceColumn[] — Array dari semua DataSourceColumn di 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

---

getDataSourceSheets()

Menampilkan sheet sumber data yang terkait dengan sumber data ini.

Pulang pergi

DataSourceSheet[] — Array sheet 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

---

getSpec()

Mendapatkan spesifikasi sumber data.

Pulang pergi

DataSourceSpec — Spesifikasi 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

---

refreshAllLinkedDataSourceObjects()

Memuat ulang semua objek sumber data yang ditautkan ke sumber data.

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

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

---

updateSpec(spec)

Memperbarui spesifikasi sumber data dan memuat ulang objek sumber data yang ditautkan dengan sumber data ini dengan spesifikasi baru.

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

Menampilkan pengecualian jika jenis spesifikasi sumber data berbeda dengan jenis sumber data saat ini.

Parameter

Nama	Jenis	Deskripsi
spec	DataSourceSpec	Spesifikasi sumber data yang akan diperbarui.

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

---

updateSpec(spec, refreshAllLinkedObjects)

Memperbarui spesifikasi sumber data dan memuat ulang data source sheets tertaut dengan spesifikasi baru.

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

Menampilkan pengecualian jika jenis spesifikasi sumber data berbeda dengan jenis sumber data saat ini.

Parameter

Nama	Jenis	Deskripsi
spec	DataSourceSpec	Spesifikasi sumber data yang akan diperbarui.
refreshAllLinkedObjects	Boolean	Jika true, juga muat ulang semua objek sumber data yang ditautkan dengan sumber data ini.

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

---

waitForAllDataExecutionsCompletion(timeoutInSeconds)

Menunggu hingga semua eksekusi saat ini dari objek sumber data tertaut selesai, waktu tunggu akan habis setelah jumlah detik yang diberikan. Menampilkan pengecualian jika eksekusi tidak selesai saat waktu tunggu habis, tetapi tidak membatalkan eksekusi data.

Parameter

Nama	Jenis	Deskripsi
timeoutInSeconds	Integer	Waktu tunggu eksekusi data, dalam detik. Durasi maksimumnya adalah 300 detik.

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