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

Class DataSource

Uzyskaj dostęp do istniejącego źródła danych i zmodyfikuj je. Aby utworzyć tabelę źródeł danych z nowym źródłem danych, zajrzyj do DataSourceTable.

tej klasy używaj tylko z danymi połączonymi z bazą danych.

Metody

Metoda	Zwracany typ	Krótki opis
`createCalculatedColumn(name, formula)`	`DataSourceColumn`	Tworzy obliczoną kolumnę.
`createDataSourcePivotTableOnNewSheet()`	`DataSourcePivotTable`	Tworzy tabelę przestawną źródła danych z tego źródła danych w pierwszej komórce nowego arkusza.
`createDataSourceTableOnNewSheet()`	`DataSourceTable`	Tworzy tabelę źródeł danych z tego źródła w pierwszej komórce nowego arkusza.
`getCalculatedColumnByName(columnName)`	`DataSourceColumn`	Zwraca obliczoną kolumnę w źródle danych, która pasuje do nazwy kolumny.
`getCalculatedColumns()`	`DataSourceColumn[]`	Zwraca wszystkie obliczone kolumny w źródle danych.
`getColumns()`	`DataSourceColumn[]`	Zwraca wszystkie kolumny w źródle danych.
`getDataSourceSheets()`	`DataSourceSheet[]`	Zwraca arkusze źródła 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 obiekty źródeł danych połączone z tym źródłem danych o nową specyfikację.
`updateSpec(spec, refreshAllLinkedObjects)`	`DataSource`	Aktualizuje specyfikację źródła danych i odświeża `data source sheets` zgodnie z nową specyfikacją.
`waitForAllDataExecutionsCompletion(timeoutInSeconds)`	`void`	Zaczekaj, aż wszystkie bieżące wykonania połączonych obiektów źródła danych zostaną zakończone i przekroczony limit czasu sekund.

Szczegółowa dokumentacja

`createCalculatedColumn(name, formula)`

Tworzy obliczoną kolumnę.

Parametry

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

Zwróć

DataSourceColumn – nowo obliczona kolumna,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 z tego źródła danych w pierwszej komórce nowego arkusza. Efektem ubocznym jest to, że nowy arkusz stanie się aktywny.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`createDataSourceTableOnNewSheet()`

Tworzy tabelę źródeł danych z tego źródła w pierwszej komórce nowego arkusza. Jako efekt uboczny powoduje, że nowy arkusz jest aktywny.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 pasuje do nazwy kolumny.

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa obliczonej kolumny, którą chcesz pobrać.

Zwróć

DataSourceColumn – obliczona kolumna odpowiada nazwie kolumny lub null, jeśli nie ma takiej obliczonej kolumny.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getColumns()`

Zwraca wszystkie kolumny w źródle danych.

Zwróć

DataSourceColumn[] – tablica wszystkich wartości DataSourceColumn w źródle danych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getDataSourceSheets()`

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

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`getSpec()`

Pobiera specyfikację źródła danych.

Zwróć

DataSourceSpec – specyfikacja źródła danych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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.

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 obiekty źródeł danych połączone z tym źródłem danych o nową specyfikację.

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

Parametry

Nazwa	Typ	Opis
`spec`	`DataSourceSpec`	Specyfikacja źródła danych, którą chcesz zaktualizować.

Zwróć

DataSource – źródło danych,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 data source sheets zgodnie z nową specyfikacją.

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

Parametry

Nazwa	Typ	Opis
`spec`	`DataSourceSpec`	Specyfikacja źródła danych, którą chcesz zaktualizować.
`refreshAllLinkedObjects`	`Boolean`	Jeśli `true`, odświeży też wszystkie obiekty źródła danych połączone z tym źródłem danych.

Zwróć

DataSource – źródło danych,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

`waitForAllDataExecutionsCompletion(timeoutInSeconds)`

Zaczekaj, aż wszystkie bieżące wykonania połączonych obiektów źródła danych zostaną zakończone i przekroczony limit czasu sekund. Zwraca wyjątek, jeśli wykonania nie zostaną zakończone po przekroczeniu limitu czasu, ale nie anulują uruchomień danych.

Parametry

Nazwa	Typ	Opis
`timeoutInSeconds`	`Integer`	Czas oczekiwania na wykonanie danych (w sekundach). Maksymalna długość to 300 sekund.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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