Расширение Google BigQuery

Вы просматриваете документацию по Apigee Edge.
Перейдите к документации по Apigee X.
Информация

Версия 2.0.2

Вставлять строки в таблицу BigQuery. Перечислить строки из таблицы.

Требования

В нем приведена информация о том, как настроить и использовать это расширение. Прежде чем использовать расширение из прокси-сервера API с помощью правила ExtensionCallout, необходимо:

  1. Убедитесь, что в вашем аккаунте включен BigQuery API.

  2. Прежде чем пытаться вставить строки, убедитесь, что вы создали набор данных и таблицу BigQuery (с схемой).

  3. Создайте ключ для сервисного аккаунта в консоли Google Cloud.

  4. Используйте содержимое полученного JSON-файла ключа при добавлении и настройке расширения, следуя инструкциям по настройке.

О Google BigQuery

Google BigQuery – это бессерверное масштабируемое корпоративное хранилище данных, которое позволяет очень быстро выполнять запросы SQL, используя вычислительные мощности инфраструктуры Google. Поскольку управлять инфраструктурой не нужно, вы можете сосредоточиться на анализе данных, чтобы получить полезную информацию, используя знакомый вам язык SQL без помощи администратора базы данных.

Чтобы получить практические навыки, попробуйте краткое руководство по Google BigQuery.

Действия

insert

Вставьте набор записей в виде набора данных непосредственно в BigQuery, указав строки для вставки, а также идентификаторы набора данных и таблицы.

Синтаксис

<Action>insert</Action>
<Input><![CDATA[{
  "dataset" : dataset-to-insert,
  "table" : table-to-receive-data,
  "rows" : array-of-rows-to-insert
}]]></Input>

Пример

<Action>insert</Action>
<Input><![CDATA[{
  "dataset" : "TestData",
  "table" : "TestTable",
  "rows" : [
    {"technology":"CRISPR","inventorFirstName":"Jennifer","inventorLastName":"Doudna"},
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}]]></Input>

Параметры запроса

Параметр Описание Тип По умолчанию Обязательно
набор данных Идентификатор набора данных, который нужно вставить в BigQuery. Строка Нет. Да.
строки Строки, которые нужно вставить в таблицу. Массив Нет. Да.
стол Название таблицы, в которую будут добавлены данные. Строка Нет. Да.

Ответ

Нет.

listRows

Перечисляет строки в таблице, указанной по идентификатору таблицы и идентификатору набора данных.

Синтаксис

<Action>listRows</Action>
<Input><![CDATA[{
  "dataset" : ID-of-dataset-to-examine,
  "limit" : maximum-rows-to-list,
  "startIndex" : row-index-at-which-to-start-list
  "table" : ID-of-table-to-examine
}]]></Input>

Пример

<Action>listRows</Action>
<Input><![CDATA[{
  "dataset" : "TestData",
  "limit" : 2,
  "startIndex" : 1,
  "table" : "TestTable"
}]]></Input>

Параметры запроса

Параметр Описание Тип По умолчанию Обязательно
набор данных Идентификатор набора данных, из которого нужно получить список строк. Строка Нет. Да.
лимит Максимальное количество строк для списка. Целое число Нет. Нет.
startIndex Индекс строки, с которой начинается список. Целое число Нет. Нет.
стол Идентификатор таблицы, из которой нужно получить список строк. Строка Нет. Да.

Ответ

Массив rows.

{
  "rows": [
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}
Параметр Описание Тип По умолчанию Обязательно
строки Массив строк, возвращенных в результате запроса. Массив Нет. Да.

Справочник по конфигурации

При настройке и развертывании этого расширения для использования в прокси API следуйте приведенным ниже инструкциям. Инструкции по настройке расширения с помощью консоли Apigee приведены в разделе Добавление и настройка расширения.

Общие свойства расширений

Следующие свойства присутствуют для каждого расширения.

Свойство Описание По умолчанию Необходимый
name Имя, которое вы даете этой конфигурации расширения. Никто Да
packageName Имя пакета расширения, предоставленное Apigee Edge. Никто Да
version Номер версии пакета расширения, из которого вы настраиваете расширение. Никто Да
configuration Значение конфигурации, относящееся к добавляемому расширению. См. Свойства этого пакета расширения. Никто Да

Свойства пакета расширения

Укажите значения для следующих свойств конфигурации, относящихся к этому расширению.

Свойство Описание По умолчанию Обязательно
Идентификатор проекта Идентификатор проекта Google Cloud, в котором хранятся данные. Нет. Да.
учетные данные При вводе в консоли Apigee Edge это содержимое файла ключа сервисного аккаунта. При отправке с помощью API управления это значение в кодировке base64, сгенерированное из файла ключа сервисного аккаунта. Нет. Да.