Class DataSource

DataSource

Mevcut veri kaynağına erişip değiştirin. Yeni veri kaynağıyla 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öntemDönüş türüKısa açıklama
cancelAllLinkedDataSourceObjectRefreshes()voidBu veri kaynağına bağlı veri kaynağı nesnelerinin şu anda çalışan tüm yenileme işlemlerini iptal eder.
createCalculatedColumn(name, formula)DataSourceColumnHesaplanmış bir sütun oluşturur.
createDataSourcePivotTableOnNewSheet()DataSourcePivotTableYeni bir sayfanın ilk hücresinde bu veri kaynağından bir veri kaynağı pivot tablosu oluşturur.
createDataSourceTableOnNewSheet()DataSourceTableYeni bir sayfanın ilk hücresinde bu veri kaynağından bir veri kaynağı tablosu oluşturur.
getCalculatedColumnByName(columnName)DataSourceColumn|nullVeri kaynağında, sütun adıyla eşleşen hesaplanmış sütunu döndürür.
getCalculatedColumns()DataSourceColumn[]Veri kaynağındaki tüm hesaplanmış 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()DataSourceSpecVeri kaynağı spesifikasyonunu alır.
refreshAllLinkedDataSourceObjects()voidVeri kaynağına bağlı tüm veri kaynağı nesnelerini yeniler.
updateSpec(spec)DataSourceVeri kaynağı spesifikasyonunu günceller ve bu veri kaynağıyla bağlantılı veri kaynağı nesnelerini yeni spesifikasyonla yeniler.
updateSpec(spec, refreshAllLinkedObjects)DataSourceVeri kaynağı spesifikasyonunu günceller ve bağlı data source sheets öğesini yeni spesifikasyonla yeniler.
waitForAllDataExecutionsCompletion(timeoutInSeconds)voidBağlı veri kaynağı nesnelerinin mevcut tüm yürütme işlemleri tamamlanana kadar bekler ve belirtilen saniye sayısı geçtikten sonra zaman aşımına uğrar.

Ayrıntılı belgeler

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 oluşturur. Belirli veri kaynağı türü için veri yürütmeyi etkinleştirmek üzere SpreadsheetApp#enable...Execution() yöntemlerini kullanın.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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

AdTürAçıklama
nameStringHesaplanmış sütunun adı.
formulaStringHesaplanmış sütun formülü.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

createDataSourcePivotTableOnNewSheet()

Yeni bir sayfanın ilk hücresinde bu veri kaynağından bir veri kaynağı pivot tablosu oluşturur. Yan etki olarak, yeni sayfayı etkin sayfa yapar.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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. Yan etki olarak, yeni sayfayı etkin sayfa 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getCalculatedColumnByName(columnName)

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

Parametreler

AdTürAçıklama
columnNameStringAlınacak hesaplanmış sütunun adı.

Return

DataSourceColumn|null: 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getCalculatedColumns()

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

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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 öğelerinin dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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ğı sayfaları dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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 oluşturur. Belirli veri kaynağı türü için veri yürütmeyi etkinleştirmek üzere SpreadsheetApp#enable...Execution() yöntemlerini kullanın.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

updateSpec(spec)

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

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

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

Parametreler

AdTürAçıklama
specDataSourceSpecGüncellenecek veri kaynağı spesifikasyonu.

Return

DataSource: Veri kaynağı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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 öğesini yeni spesifikasyonla yeniler.

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

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

Parametreler

AdTürAçıklama
specDataSourceSpecGüncellenecek veri kaynağı spesifikasyonu.
refreshAllLinkedObjectsBooleantrue seçeneği, bu veri kaynağıyla bağlantılı tüm veri kaynağı nesnelerini de yeniler.

Return

DataSource: Veri kaynağı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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ütmeleri tamamlanana kadar bekler ve belirtilen saniye sayısı geçtikten sonra zaman aşımına uğrar. Zaman aşımına uğradığında yürütmeler tamamlanmamışsa istisna oluşturur ancak veri yürütmelerini iptal etmez.

Parametreler

AdTürAçıklama
timeoutInSecondsIntegerVeri yürütme işlemleri için beklenecek süre (saniye cinsinden). Maksimum süre 300 saniyedir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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