Bu sayfa, Cloud Translation API ile çevrilmiştir.

Class DataSourceTable

Mevcut veri kaynağı tablosuna erişin ve tabloyu değiştirin. Yeni bir sayfada yeni bir veri kaynağı tablosu oluşturmak için Spreadsheet.insertSheetWithDataSourceTable(spec) işlevini kullanın.

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

Bu örnekte, yeni bir veri kaynağı tablosunun nasıl oluşturulacağı gösterilmektedir.

SpreadsheetApp.enableBigQueryExecution();
var spreadsheet = SpreadsheetApp.getActive();
var spec = SpreadsheetApp.newDataSourceSpec()
           .asBigQuery()
           .setProjectId('big_query_project')
           .setRawQuery('select @FIELD from table limit @LIMIT')
           .setParameterFromCell('FIELD', 'Sheet1!A1')
           .setParameterFromCell('LIMIT', 'namedRangeCell')
           .build();
// Starts data execution asynchronously.
var dataSheet = spreadsheet.insertSheetWithDataSourceTable(spec);
var dataSourceTable = dataSheet.getDataSourceTables()[0];
// waitForCompletion() blocks script execution until data execution completes.
dataSourceTable.waitForCompletion(60);
// Check status after execution.
Logger.log("Data execution state: %s.", dataSourceTable.getStatus().getExecutionState());

Bu örnekte, bir veri kaynağının nasıl düzenleneceği gösterilmektedir.

SpreadsheetApp.enableBigQueryExecution();
var dataSheet = SpreadsheetApp.getActive().getSheetByName("Data Sheet 1");
var dataSourceTable = dataSheet.getDataSourceTables()[0];
var dataSource = dataSourceTable.getDataSource();
var newSpec = dataSource.getSpec()
              .copy()
              .asBigQuery()
              .setRawQuery('select name from table limit 2')
              .removeAllParameters()
              .build();
// Updates data source specification and starts data execution asynchronously.
dataSource.updateSpec(newSpec);
// Check status during execution.
Logger.log("Data execution state: %s.", dataSourceTable.getStatus().getExecutionState());
// waitForCompletion() blocks script execution until data execution completes.
dataSourceTable.waitForCompletion(60);
// Check status after execution.
Logger.log("Data execution state: %s.", dataSourceTable.getStatus().getExecutionState());

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`addColumns(columnNames)`	`DataSourceTable`	Veri kaynağı tablosuna sütun ekler.
`addFilter(columnName, filterCriteria)`	`DataSourceTable`	Veri kaynağı tablosuna uygulanan bir filtre ekler.
`addSortSpec(columnName, ascending)`	`DataSourceTable`	Veri kaynağı tablosundaki bir sütuna sıralama spesifikasyonu ekler.
`addSortSpec(columnName, sortOrder)`	`DataSourceTable`	Veri kaynağı tablosundaki bir sütuna sıralama spesifikasyonu ekler.
`forceRefreshData()`	`DataSourceTable`	Geçerli durumdan bağımsız olarak bu nesnenin verilerini yeniler.
`getColumns()`	`DataSourceTableColumn[]`	Veri kaynağı tablosuna eklenen tüm veri kaynağı sütunlarını alır.
`getDataSource()`	`DataSource`	Nesnenin bağlı olduğu veri kaynağını alır.
`getFilters()`	`DataSourceTableFilter[]`	Veri kaynağı tablosuna uygulanan tüm filtreleri döndürür.
`getRange()`	`Range`	Bu veri kaynağı tablosunun kapsadığı `Range` değerini alır.
`getRowLimit()`	`Integer`	Veri kaynağı tablosunun satır sınırını döndürür.
`getSortSpecs()`	`SortSpec[]`	Veri kaynağı tablosundaki tüm sıralama özelliklerini alır.
`getStatus()`	`DataExecutionStatus`	Nesnenin veri yürütme durumunu alır.
`isSyncingAllColumns()`	`Boolean`	Veri kaynağı tablosunun, ilişkili veri kaynağındaki tüm sütunları senkronize edip etmediğini döndürür.
`refreshData()`	`DataSourceTable`	Nesnenin verilerini yeniler.
`removeAllColumns()`	`DataSourceTable`	Veri kaynağı tablosundaki tüm sütunları kaldırır.
`removeAllSortSpecs()`	`DataSourceTable`	Veri kaynağı tablosundaki tüm sıralama özelliklerini kaldırır.
`setRowLimit(rowLimit)`	`DataSourceTable`	Veri kaynağı tablosunun satır sınırını günceller.
`syncAllColumns()`	`DataSourceTable`	İlişkili veri kaynağında bulunan ve gelecekte mevcut olacak tüm sütunları veri kaynağı tablosuyla senkronize edin.
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	Mevcut yürütme işlemi tamamlanana kadar bekler ve sağlanan saniye sayısından sonra zaman aşımına uğrar.

Ayrıntılı belgeler

`addColumns(columnNames)`

Veri kaynağı tablosuna sütun ekler.

Parametreler

Ad	Tür	Açıklama
`columnNames`	`String[]`	Eklenecek sütunların adlarının listesi.

Return

DataSourceTable: Zincirleme için veri kaynağı tablosu.

Yetkilendirme

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

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

`addFilter(columnName, filterCriteria)`

Veri kaynağı tablosuna uygulanan bir filtre ekler.

Parametreler

Ad	Tür	Açıklama
`columnName`	`String`	Bu filtrenin uygulanacağı sütunun adı.
`filterCriteria`	`FilterCriteria`	Uygulanacak filtre ölçütleri.

Return

DataSourceTable: Zincirleme için veri kaynağı tablosu.

Yetkilendirme

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

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

`addSortSpec(columnName, ascending)`

Veri kaynağı tablosundaki bir sütuna sıralama spesifikasyonu ekler.

Parametreler

Ad	Tür	Açıklama
`columnName`	`String`	Sıralama için sütunun adı.
`ascending`	`Boolean`	Sütun `true` ise artan düzende; `false` ise büyükten küçüğe sıralayın.

Return

DataSourceTable: Zincirleme için veri kaynağı sayfası.

Yetkilendirme

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

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

`addSortSpec(columnName, sortOrder)`

Veri kaynağı tablosundaki bir sütuna sıralama spesifikasyonu ekler.

Parametreler

Ad	Tür	Açıklama
`columnName`	`String`	Sıralama için sütunun adı.
`sortOrder`	`SortOrder`	Sıralama düzeni.

Return

DataSourceTable: Zincirleme için veri kaynağı sayfası.

Yetkilendirme

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

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

`forceRefreshData()`

Geçerli durumdan bağımsız olarak bu nesnenin verilerini yeniler. Daha fazla bilgi için refreshData() sayfasını ziyaret edin.

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

Return

DataSourceTable: Veri nesnesi.

Yetkilendirme

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

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

`getColumns()`

Veri kaynağı tablosuna eklenen tüm veri kaynağı sütunlarını alır.

Return

DataSourceTableColumn[]: Veri kaynağı tablo sütunlarının listesi.

Yetkilendirme

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

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

`getDataSource()`

Nesnenin bağlı olduğu veri kaynağını alır.

Return

DataSource: Veri kaynağı.

Yetkilendirme

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

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

`getFilters()`

Veri kaynağı tablosuna uygulanan tüm filtreleri döndürür.

Return

DataSourceTableFilter[]: Veri kaynağı tablosuna uygulanan tüm filtrelerin dizisi.

Yetkilendirme

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

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

`getRange()`

Bu veri kaynağı tablosunun kapsadığı Range değerini alır.

Return

Range: Aralık.

Yetkilendirme

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

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

`getRowLimit()`

Veri kaynağı tablosunun satır sınırını döndürür.

Return

Integer: Veri kaynağı tablosunun satır sınırı veya herhangi bir sınır belirlenmemişse ve tablo, Google E-Tablolar kullanıcı arayüzündeki gibi varsayılan maksimum sınırı kullanırsa null.

Yetkilendirme

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

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

`getSortSpecs()`

Veri kaynağı tablosundaki tüm sıralama özelliklerini alır.

Return

SortSpec[] — Sıralama özelliklerinin listesi.

Yetkilendirme

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

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

`getStatus()`

Nesnenin veri yürütme durumunu alır.

Return

DataExecutionStatus: Veri yürütme durumu.

Yetkilendirme

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

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

`isSyncingAllColumns()`

Veri kaynağı tablosunun, ilişkili veri kaynağındaki tüm sütunları senkronize edip etmediğini döndürür.

Return

Boolean: Veri kaynağı tablosu, ilişkili veri kaynağındaki tüm sütunları senkronize ediyorsa True, aksi takdirde false.

Yetkilendirme

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

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

`refreshData()`

Nesnenin verilerini yeniler.

Şu anda error durumundaysa istisna oluşturur. Belirtimi güncellemek için DataSource#updateSpec() öğesini kullanın. Veri kaynağında beklenmeyen düzenlemeleri önlemek için bu yöntem forceRefreshData() yerine tercih edilir.

Return

DataSourceTable: Veri nesnesi.

Yetkilendirme

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

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

`removeAllColumns()`

Veri kaynağı tablosundaki tüm sütunları kaldırır.

Return

DataSourceTable: Zincirleme için veri kaynağı tablosu.

Yetkilendirme

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

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

`removeAllSortSpecs()`

Veri kaynağı tablosundaki tüm sıralama özelliklerini kaldırır.

Return

DataSourceTable: Zincirleme için veri kaynağı sayfası.

Yetkilendirme

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

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

`setRowLimit(rowLimit)`

Veri kaynağı tablosunun satır sınırını günceller. Satır sınırı null ise veri kaynağı tablosu, Google E-Tablolar kullanıcı arayüzündeki varsayılan maksimum satır sınırını kullanacak şekilde güncellenir.

Parametreler

Ad	Tür	Açıklama
`rowLimit`	`Integer`	Veri tablosu için yeni satır sınırı. `null` ise tabloyu varsayılan satır sınırını kullanacak şekilde günceller.

Return

DataSourceTable: Zincirleme için veri kaynağı tablosu.

Yetkilendirme

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

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

`syncAllColumns()`

İlişkili veri kaynağında bulunan ve gelecekte mevcut olacak tüm sütunları veri kaynağı tablosuyla senkronize edin.

Return

DataSourceTable: Zincirleme için veri kaynağı tablosu.

Yetkilendirme

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

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

`waitForCompletion(timeoutInSeconds)`

Mevcut yürütme işlemi tamamlanana kadar bekler ve sağlanan saniye sayısından sonra zaman aşımına uğrar. Yürütme işlemi, zaman aşımına uğradığında tamamlanmazsa ancak veri yürütmeyi iptal etmezse istisna oluşturur.

Parametreler

Ad	Tür	Açıklama
`timeoutInSeconds`	`Integer`	Veri yürütülmesi için beklenecek saniye (saniye cinsinden). Maksimum süre 300 saniyedir.

Return

DataExecutionStatus: Veri yürütme durumu.

Yetkilendirme

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

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