Доступ и изменение существующей сводной таблицы источника данных. Чтобы создать новую сводную таблицу источника данных, используйте Range.createDataSourcePivotTable(dataSource)
.
Используйте этот класс только с данными, подключенными к базе данных.
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
add Column Group(columnName) | Pivot Group | Добавляет новую группу сводных столбцов на основе указанного столбца источника данных. |
add Filter(columnName, filterCriteria) | Pivot Filter | Добавляет новый фильтр на основе указанного столбца источника данных с указанными критериями фильтра. |
add Pivot Value(columnName) | Pivot Value | Добавляет новое сводное значение на основе указанного столбца источника данных без какой-либо функции суммирования. |
add Pivot Value(columnName, summarizeFunction) | Pivot Value | Добавляет новое сводное значение на основе указанного столбца источника данных с указанной функцией суммирования. |
add Row Group(columnName) | Pivot Group | Добавляет новую группу сводных строк на основе указанного столбца источника данных. |
as Pivot Table() | Pivot Table | Возвращает сводную таблицу источника данных как обычный объект сводной таблицы. |
cancel Data Refresh() | Data Source Pivot Table | Отменяет обновление данных, связанное с этим объектом, если оно в данный момент выполняется. |
force Refresh Data() | Data Source Pivot Table | Обновляет данные этого объекта независимо от текущего состояния. |
get Data Source() | Data Source | Получает источник данных, с которым связан объект. |
get Status() | Data Execution Status | Получает статус выполнения данных объекта. |
refresh Data() | Data Source Pivot Table | Обновляет данные объекта. |
wait For Completion(timeoutInSeconds) | Data Execution Status | Ожидает завершения текущего выполнения, время ожидания истекает через указанное количество секунд. |
Подробная документация
add Column Group(columnName)
Добавляет новую группу сводных столбцов на основе указанного столбца источника данных.
Параметры
Имя | Тип | Описание |
---|---|---|
column Name | String | Имя столбца источника данных, на котором основана сводная группа. |
Возвращаться
Pivot Group
— новая сводная группа.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
add Filter(columnName, filterCriteria)
Добавляет новый фильтр на основе указанного столбца источника данных с указанными критериями фильтра.
Параметры
Имя | Тип | Описание |
---|---|---|
column Name | String | Имя столбца источника данных, на котором основан фильтр. |
filter Criteria | Filter Criteria | Критерии, которые использует фильтр. |
Возвращаться
Pivot Filter
— новый фильтр.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
add Pivot Value(columnName)
Добавляет новое сводное значение на основе указанного столбца источника данных без какой-либо функции суммирования. Только для измерений Looker.
В следующем коде показано, как можно добавить меру Looker в качестве сводного значения.
// TODO(developer): Replace with your spreadsheet ID which has a Looker data // source. const spreadsheet = SpreadsheetApp.openById('abcd1234'); const datasource = spreadsheet.getDataSources()[0]; const pivotTable = datasource.createDataSourcePivotTableOnNewSheet(); pivotTable.addPivotValue('columnName');
Этот метод доступен только для источников данных Looker.
Параметры
Имя | Тип | Описание |
---|---|---|
column Name | String | Имя столбца источника данных, на котором основано сводное значение. |
Возвращаться
Pivot Value
— новое опорное значение.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
add Pivot Value(columnName, summarizeFunction)
Добавляет новое сводное значение на основе указанного столбца источника данных с указанной функцией суммирования.
Чтобы добавить значения сводки для мер Looker, используйте add Pivot Value(columnName)
.
Параметры
Имя | Тип | Описание |
---|---|---|
column Name | String | Имя столбца источника данных, на котором основано сводное значение. |
summarize Function | Pivot TableSummarizeFunction | Функция суммирования, которую использует сводное значение. |
Возвращаться
Pivot Value
— новое опорное значение.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
add Row Group(columnName)
Добавляет новую группу сводных строк на основе указанного столбца источника данных.
Параметры
Имя | Тип | Описание |
---|---|---|
column Name | String | Имя столбца источника данных, на котором основана сводная группа. |
Возвращаться
Pivot Group
— новая сводная группа.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
as Pivot Table()
Возвращает сводную таблицу источника данных как обычный объект сводной таблицы.
Возвращаться
Pivot Table
— сводная таблица.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
cancel Data Refresh()
Отменяет обновление данных, связанное с этим объектом, если оно в данный момент выполняется.
В этом примере показано, как отменить обновление формулы.
const spreadsheet = SpreadsheetApp.getActive(); const formula = spreadsheet.getDataSourceFormulas()[0]; // Cancel the ongoing refresh on the formula. formula.cancelDataRefresh();
Выдает исключение, если тип источника данных не включен. Используйте методы Spreadsheet App#enable...Execution()
чтобы включить выполнение данных для определенного типа источника данных.
Возвращаться
Data Source Pivot Table
— объект данных.
Авторизация
Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
force Refresh Data()
Обновляет данные этого объекта независимо от текущего состояния. См refresh Data()
для получения более подробной информации. Если вы хотите отменить текущее обновление этого объекта, см. раздел cancel Data Refresh()
.
Выдает исключение, если тип источника данных не включен. Используйте методы Spreadsheet App#enable...Execution()
чтобы включить выполнение данных для определенного типа источника данных.
Возвращаться
Data Source Pivot Table
— объект данных.
Авторизация
Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Source()
Получает источник данных, с которым связан объект.
Возвращаться
Data Source
— источник данных.
Авторизация
Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Status()
Получает статус выполнения данных объекта.
Возвращаться
Data Execution Status
— статус выполнения данных.
Авторизация
Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refresh Data()
Обновляет данные объекта.
Выдает исключение, если в данный момент находится в состоянии error
. Используйте Data Source#updateSpec()
для обновления спецификации. Этот метод предпочтительнее force Refresh Data()
чтобы предотвратить неожиданные изменения в источнике данных.
Выдает исключение, если тип источника данных не включен. Используйте методы Spreadsheet App#enable...Execution()
чтобы включить выполнение данных для определенного типа источника данных.
Возвращаться
Data Source Pivot Table
— объект данных.
Авторизация
Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
wait For Completion(timeoutInSeconds)
Ожидает завершения текущего выполнения, время ожидания истекает через указанное количество секунд. Вызывает исключение, если выполнение не завершено по истечении времени ожидания, но не отменяет выполнение данных.
Параметры
Имя | Тип | Описание |
---|---|---|
timeout In Seconds | Integer | Время ожидания выполнения данных в секундах. Максимум — 300 секунд. |
Возвращаться
Data Execution Status
— статус выполнения данных.
Авторизация
Скрипты, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets