Mevcut veri kaynağına erişme ve bu kaynağı değiştirme. Yeni bir veri kaynağına sahip 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ö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 yenilemelerini iptal eder. |
createCalculatedColumn(name, formula) | DataSourceColumn | Hesaplanmış bir sütun oluşturur. |
createDataSourcePivotTableOnNewSheet() | DataSourcePivotTable | Yeni bir sayfanın 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ğında, sütun adıyla eşleşen hesaplanan 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() | 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ğıyla bağlantılı veri kaynağı nesnelerini yeni spesifikasyonla yeniler. |
updateSpec(spec, refreshAllLinkedObjects) | DataSource | Veri kaynağı spesifikasyonunu günceller ve bağlantılı data
source sheets öğesini yeni spesifikasyonla yeniler. |
waitForAllDataExecutionsCompletion(timeoutInSeconds) | void | Bağlı veri kaynağı nesnelerinin tüm mevcut yürütme işlemleri tamamlanana kadar bekler ve sağlanan saniye sayısı dolduktan 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 yenilemelerini 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 bir istisna oluşturur. Belirli veri kaynağı türünde veri yürütmeyi etkinleştirmek için
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.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Hesaplanan sütunun adı. |
formula | String | Hesaplanan 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 haline getirir.
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 haline getirir.
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 hesaplanan sütunu döndürür.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnName | String | Alınacak hesaplanan 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 biri 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.
Return
DataSourceColumn[]
— Veri kaynağındaki hesaplanmış tüm sütunları içeren dizi.
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
öğelerini içeren dizi.
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ü etkin değilse bir istisna oluşturur. Belirli veri kaynağı türünde veri yürütmeyi etkinleştirmek için 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ü etkin değilse bir istisna oluşturur. Belirli veri kaynağı türünde veri yürütmeyi etkinleştirmek için SpreadsheetApp#enable...Execution()
yöntemlerini kullanın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
spec | DataSourceSpec | Gü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ğlantılı data
source sheets
öğesini yeni spesifikasyonla yeniler.
Veri kaynağı türü etkin değilse bir istisna oluşturur. Belirli veri kaynağı türünde veri yürütmeyi etkinleştirmek için SpreadsheetApp#enable...Execution()
yöntemlerini kullanın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
spec | DataSourceSpec | Güncellenecek 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ı, 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 tüm mevcut yürütme işlemleri tamamlanana kadar bekler ve sağlanan saniye sayısı dolduktan sonra zaman aşımına uğrar. Zaman aşımına uğrarken yürütme işlemleri tamamlanmazsa ancak veri yürütme işlemlerini iptal etmezse bir istisna oluşturur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
timeoutInSeconds | Integer | Veri yürütmeleri 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