Auf vorhandene Datenquellen zugreifen und diese bearbeiten Informationen zum Erstellen einer Datenquellentabelle mit einer neuen Datenquelle finden Sie unter Data
.
Verwenden Sie diese Klasse nur mit Daten, die mit einer Datenbank verbunden sind.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
cancel | void | Alle derzeit laufenden Aktualisierungen von Datenquellenobjekten, die mit dieser Datenquelle verknüpft sind, werden abgebrochen. |
create | Data | Erstellt eine berechnete Spalte. |
create | Data | Hiermit wird in der ersten Zelle eines neuen Tabellenblatts eine Pivot-Tabelle für die Datenquelle erstellt. |
create | Data | Hiermit wird in der ersten Zelle eines neuen Tabellenblatts eine Datenquellentabelle aus dieser Datenquelle erstellt. |
get | Data | Gibt die berechnete Spalte in der Datenquelle zurück, die mit dem Spaltennamen übereinstimmt. |
get | Data | Gibt alle berechneten Spalten in der Datenquelle zurück. |
get | Data | Gibt alle Spalten in der Datenquelle zurück. |
get | Data | Die mit dieser Datenquelle verknüpften Datenquellenblätter werden zurückgegeben. |
get | Data | Ruft die Datenquellenspezifikation ab. |
refresh | void | Alle mit der Datenquelle verknüpften Datenquellenobjekte werden aktualisiert. |
update | Data | Aktualisiert die Datenquellenspezifikation und aktualisiert die mit dieser Datenquelle verknüpften Datenquellenobjekte mit der neuen Spezifikation. |
update | Data | Aktualisiert die Datenquellenspezifikation und aktualisiert die verknüpfte data
source sheets mit der neuen Spezifikation. |
wait | void | Wartet, bis alle aktuellen Ausführungen der verknüpften Datenquellenobjekte abgeschlossen sind. Nach der angegebenen Anzahl von Sekunden tritt eine Zeitüberschreitung auf. |
Detaillierte Dokumentation
cancel All Linked Data Source Object Refreshes()
Alle derzeit laufenden Aktualisierungen von Datenquellenobjekten, die mit dieser Datenquelle verknüpft sind, werden abgebrochen.
In diesem Beispiel wird gezeigt, wie Sie alle Aktualisierungen einer Datenquelle abbrechen.
SpreadsheetApp .enableBigQueryExecution(); const spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); const dataSource = spreadsheet.getDataSources()[0]; dataSource.cancelAllLinkedDataSourceObjectRefreshes();
Löst eine Ausnahme aus, wenn der Datenquellentyp nicht aktiviert ist. Verwenden Sie Spreadsheet
-Methoden, um die Datenausführung für den jeweiligen Datenquellentyp zu aktivieren.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
create Calculated Column(name, formula)
Erstellt eine berechnete Spalte. Diese Methode ist nur für BigQuery-Datenquellen verfügbar.
Parameter
Name | Typ | Beschreibung |
---|---|---|
name | String | Der Name der berechneten Spalte. |
formula | String | Die Formel für die berechnete Spalte. |
Rückflug
Data
: Die neu erstellte berechnete Spalte.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
create Data Source Pivot Table On New Sheet()
Hiermit wird in der ersten Zelle eines neuen Tabellenblatts eine Pivot-Tabelle für die Datenquelle erstellt. Als Nebeneffekt wird das neue Tabellenblatt zum aktiven Tabellenblatt.
Rückflug
Data
: Die neu erstellte Datenquellen-Pivot-Tabelle.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
create Data Source Table On New Sheet()
Hiermit wird in der ersten Zelle eines neuen Tabellenblatts eine Datenquellentabelle aus dieser Datenquelle erstellt. Als Nebeneffekt wird die neue Tabelle zur aktiven Tabelle.
Diese Methode ist nur für BigQuery-Datenquellen verfügbar.
Rückflug
Data
: Die neu erstellte Datenquellentabelle.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Calculated Column By Name(columnName)
Gibt die berechnete Spalte in der Datenquelle zurück, die mit dem Spaltennamen übereinstimmt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
column | String | Der Name der berechneten Spalte, die abgerufen werden soll. |
Rückflug
Data
: Die berechnete Spalte, die mit dem Spaltennamen übereinstimmt, oder null
, wenn es keine solche berechnete Spalte gibt.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Calculated Columns()
Gibt alle berechneten Spalten in der Datenquelle zurück.
Bei Datenquellenspezifikationen vom Typ Data
wird ein leeres Array zurückgegeben.
Rückflug
Data
: Ein Array aller berechneten Spalten in der Datenquelle.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Columns()
Gibt alle Spalten in der Datenquelle zurück.
Rückflug
Data
: Ein Array aller Data
in der Datenquelle.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Source Sheets()
Die mit dieser Datenquelle verknüpften Datenquellenblätter werden zurückgegeben.
Rückflug
Data
: ein Array von Tabellen mit Datenquellen.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Spec()
Ruft die Datenquellenspezifikation ab.
Rückflug
Data
: Datenquellenspezifikation.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refresh All Linked Data Source Objects()
Alle mit der Datenquelle verknüpften Datenquellenobjekte werden aktualisiert.
Löst eine Ausnahme aus, wenn der Datenquellentyp nicht aktiviert ist. Verwenden Sie Spreadsheet
-Methoden, um die Datenausführung für den jeweiligen Datenquellentyp zu aktivieren.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
update Spec(spec)
Aktualisiert die Datenquellenspezifikation und aktualisiert die mit dieser Datenquelle verknüpften Datenquellenobjekte mit der neuen Spezifikation.
Löst eine Ausnahme aus, wenn der Datenquellentyp nicht aktiviert ist. Verwenden Sie Spreadsheet
-Methoden, um die Datenausführung für den jeweiligen Datenquellentyp zu aktivieren.
Es wird eine Ausnahme ausgelöst, wenn der Typ der Datenquellenspezifikation nicht mit dem aktuellen Datenquellentyp übereinstimmt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
spec | Data | Die Datenquellenspezifikation, mit der die Daten aktualisiert werden sollen. |
Rückflug
Data
: Datenquelle
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
update Spec(spec, refreshAllLinkedObjects)
Aktualisiert die Datenquellenspezifikation und aktualisiert die verknüpfte data
source sheets
mit der neuen Spezifikation.
Löst eine Ausnahme aus, wenn der Datenquellentyp nicht aktiviert ist. Verwenden Sie Spreadsheet
-Methoden, um die Datenausführung für den jeweiligen Datenquellentyp zu aktivieren.
Es wird eine Ausnahme ausgelöst, wenn der Typ der Datenquellenspezifikation nicht mit dem aktuellen Datenquellentyp übereinstimmt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
spec | Data | Die Datenquellenspezifikation, mit der die Daten aktualisiert werden sollen. |
refresh | Boolean | Wenn true , werden auch alle mit dieser Datenquelle verknüpften Datenquellenobjekte aktualisiert. |
Rückflug
Data
: Datenquelle
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
wait For All Data Executions Completion(timeoutInSeconds)
Wartet, bis alle aktuellen Ausführungen der verknüpften Datenquellenobjekte abgeschlossen sind. Nach der angegebenen Anzahl von Sekunden tritt eine Zeitüberschreitung auf. Es wird eine Ausnahme ausgelöst, wenn die Ausführungen bei einer Zeitüberschreitung nicht abgeschlossen sind, die Datenausführungen werden jedoch nicht abgebrochen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
timeout | Integer | Die Zeit in Sekunden, die auf die Ausführung der Daten gewartet werden soll. Das Maximum beträgt 300 Sekunden. |
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets