Class DataSource

Źródło danych

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

MetodaZwracany typKrótki opis
createCalculatedColumn(name, formula)DataSourceColumnTworzy obliczoną kolumnę.
createDataSourcePivotTableOnNewSheet()DataSourcePivotTableTworzy tabelę przestawną źródła danych z tego źródła danych w pierwszej komórce nowego arkusza.
createDataSourceTableOnNewSheet()DataSourceTableTworzy tabelę źródeł danych z tego źródła w pierwszej komórce nowego arkusza.
getCalculatedColumnByName(columnName)DataSourceColumnZwraca 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()DataSourceSpecPobiera specyfikację źródła danych.
refreshAllLinkedDataSourceObjects()voidOdświeża wszystkie obiekty źródła danych połączone ze źródłem danych.
updateSpec(spec)DataSourceAktualizuje 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)DataSourceAktualizuje specyfikację źródła danych i odświeża data source sheets zgodnie z nową specyfikacją.
waitForAllDataExecutionsCompletion(timeoutInSeconds)voidZaczekaj, 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

NazwaTypOpis
nameStringNazwa obliczonej kolumny.
formulaStringObliczona 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

NazwaTypOpis
columnNameStringNazwa 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

NazwaTypOpis
specDataSourceSpecSpecyfikacja ź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

NazwaTypOpis
specDataSourceSpecSpecyfikacja źródła danych, którą chcesz zaktualizować.
refreshAllLinkedObjectsBooleanJeś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

NazwaTypOpis
timeoutInSecondsIntegerCzas 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