Class DataSource

VeriKaynağı

Mevcut veri kaynağına erişme ve bu kaynağı değiştirme. Yeni veri kaynağı içeren bir veri kaynağı tablosu oluşturmak için DataSourceTable bölümüne bakın.

Bu sınıfı yalnızca bir veritabanına bağlı verilerle kullanın.

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
cancelAllLinkedDataSourceObjectRefreshes()	void	Bu veri kaynağına bağlı veri kaynağı nesnelerinin şu anda çalışan tüm yenileme işlemlerini iptal eder.
createCalculatedColumn(name, formula)	DataSourceColumn	Hesaplanmış bir sütun oluşturur.
createDataSourcePivotTableOnNewSheet()	DataSourcePivotTable	Yeni bir e-tablonun ilk hücresinde bu veri kaynağından bir veri kaynağı pivot tablosu oluşturur.
createDataSourceTableOnNewSheet()	DataSourceTable	Yeni bir sayfanın ilk hücresinde bu veri kaynağından bir veri kaynağı tablosu oluşturur.
getCalculatedColumnByName(columnName)	DataSourceColumn	Veri kaynağındaki sütun adıyla eşleşen hesaplanmış sütunu döndürür.
getCalculatedColumns()	DataSourceColumn[]	Veri kaynağındaki tüm hesaplanan sütunları döndürür.
getColumns()	DataSourceColumn[]	Veri kaynağındaki tüm sütunları döndürür.
getDataSourceSheets()	DataSourceSheet[]	Bu veri kaynağıyla ilişkili veri kaynağı sayfalarını döndürür.
getSpec()	DataSourceSpec	Veri kaynağı spesifikasyonunu alır.
refreshAllLinkedDataSourceObjects()	void	Veri kaynağına bağlı tüm veri kaynağı nesnelerini yeniler.
updateSpec(spec)	DataSource	Veri kaynağı spesifikasyonunu günceller ve bu veri kaynağına bağlı veri kaynağı nesnelerini yeni spesifikasyonla yeniler.
updateSpec(spec, refreshAllLinkedObjects)	DataSource	Veri kaynağı spesifikasyonunu günceller ve bağlı data source sheets'yi yeni spesifikasyonla yeniler.
waitForAllDataExecutionsCompletion(timeoutInSeconds)	void	Bağlı veri kaynağı nesnelerinin mevcut tüm yürütmelerinin tamamlanmasını bekler ve belirtilen saniye sayısından sonra zaman aşımına uğrar.

Ayrıntılı dokümanlar

cancelAllLinkedDataSourceObjectRefreshes()

Bu veri kaynağına bağlı veri kaynağı nesnelerinin şu anda çalışan tüm yenileme işlemlerini iptal eder.

Bu örnekte, bir veri kaynağının tüm yenilemelerinin nasıl iptal edileceği gösterilmektedir.

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

Veri kaynağı türü etkinleştirilmemişse istisna atar. Belirli bir veri kaynağı türü için veri yürütme işlemini etkinleştirmek üzere SpreadsheetApp#enable...Execution() yöntemlerini kullanın.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

---

createCalculatedColumn(name, formula)

Hesaplanmış bir sütun oluşturur. Bu yöntem yalnızca BigQuery veri kaynakları için kullanılabilir.

Parametreler

Ad	Tür	Açıklama
name	String	Hesaplanmış sütunun adı.
formula	String	Hesaplanmış sütun formülü.

Return

DataSourceColumn: Yeni oluşturulan hesaplanmış sütun.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

---

createDataSourcePivotTableOnNewSheet()

Yeni bir e-tablonun ilk hücresinde bu veri kaynağından bir veri kaynağı pivot tablosu oluşturur. Bu işlem, yan etki olarak yeni e-tabloyu etkin e-tablo yapar.

Return

DataSourcePivotTable: Yeni oluşturulan veri kaynağı pivot tablosu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

---

createDataSourceTableOnNewSheet()

Yeni bir sayfanın ilk hücresinde bu veri kaynağından bir veri kaynağı tablosu oluşturur. Bu işlem, yeni e-tabloyu etkin e-tablo yapar.

Bu yöntem yalnızca BigQuery veri kaynakları için kullanılabilir.

Return

DataSourceTable: Yeni oluşturulan veri kaynağı tablosu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

---

getCalculatedColumnByName(columnName)

Veri kaynağındaki sütun adıyla eşleşen hesaplanmış sütunu döndürür.

Parametreler

Ad	Tür	Açıklama
columnName	String	Alınacak hesaplanmış sütunun adı.

Return

DataSourceColumn: Sütun adıyla eşleşen hesaplanmış sütun veya böyle bir hesaplanmış sütun yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

---

getCalculatedColumns()

Veri kaynağındaki tüm hesaplanan sütunları döndürür.

DataSourceType.LOOKER türündeki veri kaynağı spesifikasyonları boş bir dizi döndürür.

Return

DataSourceColumn[]: Veri kaynağındaki tüm hesaplanmış sütunların dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

---

getColumns()

Veri kaynağındaki tüm sütunları döndürür.

Return

DataSourceColumn[]: Veri kaynağındaki tüm DataSourceColumn değerlerinin dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

---

getDataSourceSheets()

Bu veri kaynağıyla ilişkili veri kaynağı sayfalarını döndürür.

Return

DataSourceSheet[]: Veri kaynağı e-tabloları dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

---

getSpec()

Veri kaynağı spesifikasyonunu alır.

Return

DataSourceSpec: Veri kaynağı spesifikasyonu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

---

refreshAllLinkedDataSourceObjects()

Veri kaynağına bağlı tüm veri kaynağı nesnelerini yeniler.

Veri kaynağı türü etkinleştirilmemişse istisna atar. Belirli bir veri kaynağı türü için veri yürütme işlemini etkinleştirmek üzere SpreadsheetApp#enable...Execution() yöntemlerini kullanın.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

---

updateSpec(spec)

Veri kaynağı spesifikasyonunu günceller ve bu veri kaynağına bağlı veri kaynağı nesnelerini yeni spesifikasyonla yeniler.

Veri kaynağı türü etkinleştirilmemişse istisna atar. Belirli bir veri kaynağı türü için veri yürütme işlemini etkinleştirmek üzere SpreadsheetApp#enable...Execution() yöntemlerini kullanın.

Veri kaynağı spesifikasyon türü, mevcut veri kaynağı türünden farklıysa istisna oluşturur.

Parametreler

Ad	Tür	Açıklama
spec	DataSourceSpec	Güncelleme yapılacak veri kaynağı spesifikasyonu.

Return

DataSource: Veri kaynağı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

---

updateSpec(spec, refreshAllLinkedObjects)

Veri kaynağı spesifikasyonunu günceller ve bağlı data source sheets'yi yeni spesifikasyonla yeniler.

Veri kaynağı türü etkinleştirilmemişse istisna atar. Belirli bir veri kaynağı türü için veri yürütme işlemini etkinleştirmek üzere SpreadsheetApp#enable...Execution() yöntemlerini kullanın.

Veri kaynağı spesifikasyon türü, mevcut veri kaynağı türünden farklıysa istisna oluşturur.

Parametreler

Ad	Tür	Açıklama
spec	DataSourceSpec	Güncelleme yapılacak veri kaynağı spesifikasyonu.
refreshAllLinkedObjects	Boolean	true ise bu veri kaynağına bağlı tüm veri kaynağı nesnelerini de yeniler.

Return

DataSource: Veri kaynağı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

---

waitForAllDataExecutionsCompletion(timeoutInSeconds)

Bağlı veri kaynağı nesnelerinin mevcut tüm yürütmelerinin tamamlanmasını bekler ve belirtilen saniye sayısından sonra zaman aşımına uğrar. Zaman aşımı olduğunda yürütmeler tamamlanmazsa bir istisna atar ancak veri yürütme işlemlerini iptal etmez.

Parametreler

Ad	Tür	Açıklama
timeoutInSeconds	Integer	Saniye cinsinden veri yürütme işleminin tamamlanmasını bekleme süresi. Maksimum süre 300 saniyedir.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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