Эта страница переведена с помощью Cloud Translation API.

Class DataSourcePivotTable

Доступ и изменение существующей сводной таблицы источника данных. Чтобы создать новую сводную таблицу источника данных, используйте 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 Table Summarize Function`	Функция суммирования, которую использует сводное значение.

Возвращаться

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() .

Возвращаться

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() чтобы предотвратить неожиданные изменения в источнике данных.

Возвращаться

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