Class DataSource

DataSource

Mevcut veri kaynağına erişme ve bu kaynağı değiştirme. Yeni veri kaynağına sahip bir veri kaynağı tablosu oluşturmak için şu makaleyi inceleyin: DataSourceTable

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ğı nesnelerinde şu anda devam eden tüm yenilemeleri 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 veri kaynağı tablosu oluşturur.
getCalculatedColumnByName(columnName)DataSourceColumnVeri kaynağında, sütun adıyla eşleşen hesaplanmış sütunu döndürür.
getCalculatedColumns()DataSourceColumn[]Veri kaynağındaki hesaplanmış tüm 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 buna bağlı veri kaynağı nesnelerini yeniler yeni spesifikasyona sahip veri kaynağı oluşturun.
updateSpec(spec, refreshAllLinkedObjects)DataSourceVeri kaynağı spesifikasyonunu günceller ve bağlı data source sheets özelliğini yeni spesifikasyonla yeniler.
waitForAllDataExecutionsCompletion(timeoutInSeconds)voidBağlı veri kaynağı nesnelerinin mevcut tüm yürütmeleri tamamlanana kadar bekler ve zaman aşımına uğrar belirtilen sayıda saniye geçtikten sonra.

Ayrıntılı belgeler

cancelAllLinkedDataSourceObjectRefreshes()

Bu veri kaynağına bağlı veri kaynağı nesnelerinde şu anda devam eden tüm yenilemeleri iptal eder.

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

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

Veri kaynağı türü etkin değilse istisna atar. Belirli verilerde veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanın kaynak türü.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 bir 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. Kullanıcı yeni sayfayı etkin sayfa haline getirir.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 veri kaynağı tablosu oluşturur. Yan olarak yeni sayfayı etkin sayfa haline getirir.

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 bir 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: 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 bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getCalculatedColumns()

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

DataSourceType.LOOKER türünün veri kaynağı özellikleri 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 bir 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 öğelerini içeren bir dizi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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ğı e-tabloları dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 bir 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ü etkin değilse istisna atar. Belirli verilerde veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanın kaynak türü.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 buna bağlı veri kaynağı nesnelerini yeniler yeni spesifikasyona sahip veri kaynağı oluşturun.

Veri kaynağı türü etkin değilse istisna atar. Belirli verilerde veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanın kaynak türü.

Veri kaynağı spesifikasyon türü Mevcut veri kaynağı türünü seçin.

Parametreler

AdTürAçıklama
specDataSourceSpecGüncelleme yapılacak veri kaynağı spesifikasyonu.

Return

DataSource — Veri kaynağı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 özelliğini yeni spesifikasyonla yeniler.

Veri kaynağı türü etkin değilse istisna atar. Belirli verilerde veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanın kaynak türü.

Veri kaynağı spesifikasyon türü Mevcut veri kaynağı türünü seçin.

Parametreler

AdTürAçıklama
specDataSourceSpecGüncellenecek veri kaynağı spesifikasyonu.
refreshAllLinkedObjectsBooleantrue ise tüm veri kaynağı nesnelerini de yeniler bu veri kaynağına bağlı.

Return

DataSource — Veri kaynağı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 zaman aşımına uğrar belirtilen sayıda saniye geçtikten sonra. Yürütmeler tamamlanmazsa istisna atar zaman aşımına uğrattığını ancak veri yürütmelerini iptal etmez.

Parametreler

AdTürAçıklama
timeoutInSecondsIntegerSaniye cinsinden veri yürütme işlemi için beklenecek süre. Maksimum değer 300'dür. saniye.

Yetkilendirme

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

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