Mevcut veri kaynağına erişme ve 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öntem | Dönüş türü | Kısa açıklama |
---|---|---|
cancelAllLinkedDataSourceObjectRefreshes() | void | Bu veri kaynağına bağlı veri kaynağı nesnelerinde şu anda devam eden tüm yenilemeleri 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 veri kaynağı tablosu oluşturur. |
getCalculatedColumnByName(columnName) | DataSourceColumn | Veri 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() | 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 buna bağlı veri kaynağı nesnelerini yeniler yeni spesifikasyona sahip veri kaynağı oluşturun. |
updateSpec(spec, refreshAllLinkedObjects) | DataSource | Veri kaynağı spesifikasyonunu günceller ve bağlı data
source sheets özelliğini yeni spesifikasyonla yeniler. |
waitForAllDataExecutionsCompletion(timeoutInSeconds) | void | 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. |
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ğındaki tüm yenilemelerin 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.
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ı, 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.
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
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 sütun adıyla eşleşen bir sütun yoksa null
hesaplanmış sütunudur.
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.
Return
DataSourceColumn[]
: Veri kaynağındaki hesaplanmış tüm 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ğı sayfaları 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ü.
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 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ü.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
spec | DataSourceSpec | Güncellenecek veri kaynağı spesifikasyonu. |
refreshAllLinkedObjects | Boolean | true 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
Ad | Tür | Açıklama |
---|---|---|
timeoutInSeconds | Integer | Saniye 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