Vorhandene Datenquelle aufrufen und bearbeiten Informationen zum Erstellen einer Datenquellentabelle mit einer neuen Datenquelle finden Sie unter DataSourceTable
.
Verwenden Sie diese Klasse nur mit Daten, die mit einer Datenbank verbunden sind.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
createCalculatedColumn(name, formula) | DataSourceColumn | Erstellt eine berechnete Spalte. |
createDataSourcePivotTableOnNewSheet() | DataSourcePivotTable | Erstellt in der ersten Zelle eines neuen Tabellenblatts eine Datenquellen-Pivot-Tabelle aus dieser Datenquelle. |
createDataSourceTableOnNewSheet() | DataSourceTable | Erstellt in der ersten Zelle eines neuen Tabellenblatts eine Datenquellentabelle aus dieser Datenquelle. |
getCalculatedColumnByName(columnName) | DataSourceColumn | Gibt die berechnete Spalte in der Datenquelle zurück, die dem Spaltennamen entspricht. |
getCalculatedColumns() | DataSourceColumn[] | Gibt alle berechneten Spalten in der Datenquelle zurück. |
getColumns() | DataSourceColumn[] | Gibt alle Spalten in der Datenquelle zurück. |
getDataSourceSheets() | DataSourceSheet[] | Gibt die Datenquellentabellen zurück, die mit dieser Datenquelle verknüpft sind. |
getSpec() | DataSourceSpec | Ruft die Datenquellenspezifikation ab. |
refreshAllLinkedDataSourceObjects() | void | Alle Datenquellenobjekte, die mit der Datenquelle verknüpft sind, werden aktualisiert. |
updateSpec(spec) | DataSource | Aktualisiert die Datenquellenspezifikation und aktualisiert die Datenquellenobjekte, die mit dieser Datenquelle verknüpft sind, mit der neuen Spezifikation. |
updateSpec(spec, refreshAllLinkedObjects) | DataSource | Aktualisiert die Datenquellenspezifikation und aktualisiert die verknüpfte data
source sheets mit der neuen Spezifikation. |
waitForAllDataExecutionsCompletion(timeoutInSeconds) | void | Wartet, bis alle aktuellen Ausführungen der verknüpften Datenquellenobjekte abgeschlossen sind. Das Zeitlimit wird nach der angegebenen Anzahl von Sekunden überschritten. |
Detaillierte Dokumentation
createCalculatedColumn(name, formula)
Erstellt eine berechnete Spalte.
Parameter
Name | Typ | Beschreibung |
---|---|---|
name | String | Der Name der berechneten Spalte. |
formula | String | Die Formel für berechnete Spalten. |
Return
DataSourceColumn
: Die neu erstellte berechnete Spalte.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourcePivotTableOnNewSheet()
Erstellt in der ersten Zelle eines neuen Tabellenblatts eine Datenquellen-Pivot-Tabelle aus dieser Datenquelle. Dadurch wird das neue Tabellenblatt zum aktiven Tabellenblatt.
Return
DataSourcePivotTable
: Die neu erstellte Pivot-Tabelle der Datenquelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourceTableOnNewSheet()
Erstellt in der ersten Zelle eines neuen Tabellenblatts eine Datenquellentabelle aus dieser Datenquelle. Dadurch wird das neue Tabellenblatt zum aktiven Tabellenblatt.
Return
DataSourceTable
: Die neu erstellte Datenquellentabelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCalculatedColumnByName(columnName)
Gibt die berechnete Spalte in der Datenquelle zurück, die dem Spaltennamen entspricht.
Parameter
Name | Typ | Beschreibung |
---|---|---|
columnName | String | Der Name der berechneten Spalte, die abgerufen werden soll. |
Return
DataSourceColumn
: Die berechnete Spalte, die mit dem Spaltennamen übereinstimmt, oder null
, wenn es keine solche berechnete Spalte gibt.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCalculatedColumns()
Gibt alle berechneten Spalten in der Datenquelle zurück.
Return
DataSourceColumn[]
: Ein Array aller berechneten Spalten in der Datenquelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumns()
Gibt alle Spalten in der Datenquelle zurück.
Return
DataSourceColumn[]
: Ein Array aller DataSourceColumn
in der Datenquelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceSheets()
Gibt die Datenquellentabellen zurück, die mit dieser Datenquelle verknüpft sind.
Return
DataSourceSheet[]
: Ein Array von Datenquellentabellen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSpec()
Ruft die Datenquellenspezifikation ab.
Return
DataSourceSpec
: Die Spezifikation der Datenquelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refreshAllLinkedDataSourceObjects()
Alle Datenquellenobjekte, die mit der Datenquelle verknüpft sind, werden aktualisiert.
Löst eine Ausnahme aus, wenn der Typ der Datenquelle nicht aktiviert ist. Verwenden Sie SpreadsheetApp#enable...Execution()
-Methoden, um die Datenausführung für den jeweiligen Datenquellentyp zu aktivieren.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
updateSpec(spec)
Aktualisiert die Datenquellenspezifikation und aktualisiert die Datenquellenobjekte, die mit dieser Datenquelle verknüpft sind, mit der neuen Spezifikation.
Löst eine Ausnahme aus, wenn der Typ der Datenquelle nicht aktiviert ist. Verwenden Sie SpreadsheetApp#enable...Execution()
-Methoden, um die Datenausführung für den jeweiligen Datenquellentyp zu aktivieren.
Parameter
Name | Typ | Beschreibung |
---|---|---|
spec | DataSourceSpec | Die Datenquellenspezifikation, die aktualisiert werden soll. |
Return
DataSource
: Die Datenquelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
updateSpec(spec, refreshAllLinkedObjects)
Aktualisiert die Datenquellenspezifikation und aktualisiert die verknüpfte data
source sheets
mit der neuen Spezifikation.
Löst eine Ausnahme aus, wenn der Typ der Datenquelle nicht aktiviert ist. Verwenden Sie SpreadsheetApp#enable...Execution()
-Methoden, um die Datenausführung für den jeweiligen Datenquellentyp zu aktivieren.
Parameter
Name | Typ | Beschreibung |
---|---|---|
spec | DataSourceSpec | Die Datenquellenspezifikation, die aktualisiert werden soll. |
refreshAllLinkedObjects | Boolean | Bei true werden auch alle mit dieser Datenquelle verknüpften Datenquellenobjekte aktualisiert. |
Return
DataSource
: Die Datenquelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForAllDataExecutionsCompletion(timeoutInSeconds)
Wartet, bis alle aktuellen Ausführungen der verknüpften Datenquellenobjekte abgeschlossen sind. Das Zeitlimit wird nach der angegebenen Anzahl von Sekunden überschritten. Löst eine Ausnahme aus, wenn die Ausführungen bei einer Zeitüberschreitung nicht abgeschlossen sind, bricht die Datenausführungen jedoch nicht ab.
Parameter
Name | Typ | Beschreibung |
---|---|---|
timeoutInSeconds | Integer | Die Zeit in Sekunden, die auf Datenausführungen gewartet werden soll. Das Maximum beträgt 300 Sekunden. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets