Ta strona została przetłumaczona przez Cloud Translation API.

Class DataSource

uzyskiwać dostęp do istniejącego źródła danych i wprowadzać w nim zmiany. Aby utworzyć tabelę źródła danych z nowym źródłem danych, zapoznaj się z artykułem DataSourceTable

Używaj tej klasy tylko w przypadku danych połączonych z bazą danych.

Metody

Metoda	Zwracany typ	Krótki opis
`cancelAllLinkedDataSourceObjectRefreshes()`	`void`	Anuluje wszystkie trwające obecnie odświeżanie obiektów źródła danych połączonych z tym źródłem danych.
`createCalculatedColumn(name, formula)`	`DataSourceColumn`	Tworzy obliczoną kolumnę.
`createDataSourcePivotTableOnNewSheet()`	`DataSourcePivotTable`	Tworzy tabelę przestawną źródła danych na podstawie tego źródła danych w pierwszej komórce nowego arkusza.
`createDataSourceTableOnNewSheet()`	`DataSourceTable`	Tworzy tabelę źródła danych na podstawie tego źródła danych w pierwszej komórce nowego arkusza.
`getCalculatedColumnByName(columnName)`	`DataSourceColumn`	Zwraca obliczoną kolumnę w źródle danych, która odpowiada nazwie kolumny.
`getCalculatedColumns()`	`DataSourceColumn[]`	Zwraca wszystkie obliczone kolumny w źródle danych.
`getColumns()`	`DataSourceColumn[]`	Zwraca wszystkie kolumny ze źródła danych.
`getDataSourceSheets()`	`DataSourceSheet[]`	Zwraca arkusze źródeł danych powiązane z tym źródłem danych.
`getSpec()`	`DataSourceSpec`	Pobiera specyfikację źródła danych.
`refreshAllLinkedDataSourceObjects()`	`void`	Odświeża wszystkie obiekty źródła danych połączone ze źródłem danych.
`updateSpec(spec)`	`DataSource`	Aktualizuje specyfikację źródła danych i odświeża połączone z nią obiekty źródła danych zgodnie z nową specyfikacją.
`updateSpec(spec, refreshAllLinkedObjects)`	`DataSource`	Aktualizuje specyfikację źródła danych i odświeża połączone `data source sheets` zgodnie z nową specyfikacją.
`waitForAllDataExecutionsCompletion(timeoutInSeconds)`	`void`	Oczekiwanie na zakończenie wszystkich bieżących wykonań połączonych obiektów źródła danych, przekroczenie limitu czasu po podanej liczbie sekund.

Szczegółowa dokumentacja

`cancelAllLinkedDataSourceObjectRefreshes()`

Anuluje wszystkie trwające obecnie odświeżanie obiektów źródła danych połączonych z tym źródłem danych.

Ten przykład pokazuje, jak anulować wszystkie odświeżanie źródła danych.

SpreadsheetApp.enableBigQueryExecution();
const dataSource = spreadsheet.getDataSources()[0];
dataSource.cancelAllLinkedDataSourceObjectRefreshes();

Zgłasza wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution(), aby włączyć wykonywanie związanych z danymi danych typu źródła.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`createCalculatedColumn(name, formula)`

Tworzy obliczoną kolumnę.

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nazwa obliczonej kolumny.
`formula`	`String`	Formuła obliczonej kolumny.

Powrót

DataSourceColumn – nowo utworzona obliczona kolumna.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`createDataSourcePivotTableOnNewSheet()`

Tworzy tabelę przestawną źródła danych na podstawie tego źródła danych w pierwszej komórce nowego arkusza. Jako efekt uboczny sprawia, że nowy arkusz staje się aktywnym arkuszem.

Powrót

DataSourcePivotTable – nowo utworzona tabela przestawna źródła danych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`createDataSourceTableOnNewSheet()`

Tworzy tabelę źródła danych na podstawie tego źródła danych w pierwszej komórce nowego arkusza. Jako strona sprawia, że nowy arkusz staje się arkuszem aktywnym.

Powrót

DataSourceTable – nowo utworzona tabela źródeł danych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getCalculatedColumnByName(columnName)`

Zwraca obliczoną kolumnę w źródle danych, która odpowiada nazwie kolumny.

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa obliczonej kolumny, która ma zostać pobrana.

Powrót

DataSourceColumn – obliczona kolumna pasująca do nazwy kolumny lub null, jeśli jej nie ma obliczonej kolumny.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getCalculatedColumns()`

Zwraca wszystkie obliczone kolumny w źródle danych.

Powrót

DataSourceColumn[] – tablica wszystkich obliczonych kolumn w źródle danych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getColumns()`

Zwraca wszystkie kolumny ze źródła danych.

Powrót

DataSourceColumn[] – tablica wszystkich elementów DataSourceColumn w źródle danych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getDataSourceSheets()`

Zwraca arkusze źródeł danych powiązane z tym źródłem danych.

Powrót

DataSourceSheet[] – tablica arkuszy źródeł danych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`getSpec()`

Pobiera specyfikację źródła danych.

Powrót

DataSourceSpec – specyfikacja źródła danych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`refreshAllLinkedDataSourceObjects()`

Odświeża wszystkie obiekty źródła danych połączone ze źródłem danych.

Zgłasza wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution(), aby włączyć wykonywanie kodu dla określonych danych typu źródła.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`updateSpec(spec)`

Aktualizuje specyfikację źródła danych i odświeża połączone z nią obiekty źródła danych zgodnie z nową specyfikacją.

Zgłasza wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution(), aby włączyć wykonywanie kodu dla określonych danych typu źródła.

Parametry

Nazwa	Typ	Opis
`spec`	`DataSourceSpec`	Specyfikacja źródła danych, która ma zostać zaktualizowana.

Powrót

DataSource – źródło danych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`updateSpec(spec, refreshAllLinkedObjects)`

Aktualizuje specyfikację źródła danych i odświeża połączone data source sheets zgodnie z nową specyfikacją.

Zgłasza wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution(), aby włączyć wykonywanie kodu dla określonych danych typu źródła.

Parametry

Nazwa	Typ	Opis
`spec`	`DataSourceSpec`	Specyfikacja źródła danych, która ma zostać zaktualizowana.
`refreshAllLinkedObjects`	`Boolean`	Jeśli ustawiona jest wartość `true`, powoduje też odświeżenie wszystkich obiektów źródła danych. połączone z tym źródłem danych.

Powrót

DataSource – źródło danych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

`waitForAllDataExecutionsCompletion(timeoutInSeconds)`

Oczekiwanie na zakończenie wszystkich bieżących wykonań połączonych obiektów źródła danych, przekroczenie limitu czasu po podanej liczbie sekund. Zgłasza wyjątek, jeśli wykonania nie zostaną ukończone gdy limit czasu zostanie przekroczony, ale nie anuluje uruchomień związanych z danymi.

Parametry

Nazwa	Typ	Opis
`timeoutInSeconds`	`Integer`	Czas oczekiwania na uruchomienia danych (w sekundach). Maksymalna liczba to 300 sek.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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