Spec-Zone.ru › AWS CLI v2

[ aws . glue ]

get-unfiltered-table-metadata

Описание

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

Для авторизации IAM общедоступное действие IAM, связанное с этим API, равно glue:GetTable.

См. также: Документация AWS API

Синтаксис

  get-unfiltered-table-metadata
--catalog-id <value>
--database-name <value>
--name <value>
[--audit-context <value>]
--supported-permission-types <value>
[--parent-resource-arn <value>]
[--root-resource-arn <value>]
[--supported-dialect <value>]
[--permissions <value>]
[--query-session-context <value>]
[--resource-region <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--catalog-id (строка)

Идентификатор каталога, в котором находится таблица.

--database-name (строка)

(Обязательно) Указывает имя базы данных, содержащей таблицу.

--name (строка)

(Обязательно) Указывает имя таблицы, для которой запрашиваются метаданные.

--audit-context (структура)

Структура, содержащая информацию о контексте аудита Lake Formation.

AdditionalAuditContext -> (строка)

Строка, содержащая дополнительную информацию о контексте аудита.

RequestedColumns -> (список)

Запрашиваемые столбцы для аудита.

(строка)

AllColumnsRequested -> (булево)

Запрос на все столбцы для аудита.

Краткая синтаксическая запись:

AdditionalAuditContext=string,RequestedColumns=string,string,AllColumnsRequested=boolean

Синтаксис JSON:

{
  "AdditionalAuditContext": "string",
  "RequestedColumns": ["string", ...],
  "AllColumnsRequested": true|false
}

--supported-permission-types (список)

Указывает уровень фильтрации, который стороннее аналитическое движке способно применить при вызове операции API GetUnfilteredTableMetadata. Допустимые значения:

  • COLUMN_PERMISSION - Разрешения на столбцы гарантируют, что пользователи могут получить доступ только к определенным столбцам в таблице. Если некоторые столбцы содержат конфиденциальные данные, администраторы озера данных могут определить фильтры столбцов, исключающие доступ к определенным столбцам.
  • CELL_FILTER_PERMISSION - Фильтрация на уровне ячеек объединяет фильтрацию столбцов (включение или исключение столбцов) и выражения фильтра строк, чтобы ограничить доступ к отдельным элементам в таблице.
  • NESTED_PERMISSION - Вложенные разрешения объединяют фильтрацию на уровне ячеек и вложенную фильтрацию столбцов, чтобы ограничить доступ к столбцам и/или вложенным столбцам в определенных строках на основе выражений фильтра строк.
  • NESTED_CELL_PERMISSION - Вложенные разрешения на ячейки объединяют вложенные разрешения с вложенной фильтрацией на уровне ячеек. Это позволяет ограничивать разные подмножества вложенных столбцов на основе массива выражений фильтра строк.

Примечание. Каждый из этих типов разрешений следует иерархическому порядку, где каждый последующий тип разрешений включает все разрешения предыдущего типа.

Важно: если вы предоставите поддерживаемый тип разрешения, который не соответствует уровню разрешений пользователя на таблицу, Lake Formation генерирует исключение. Например, если стороннее движке, вызывающее операцию GetUnfilteredTableMetadata, может применять только фильтрацию на уровне столбцов, а пользователь имеет примененную фильтрацию на уровне вложенных ячеек для таблицы, Lake Formation генерирует исключение и не возвращает нефильтрованные метаданные таблицы и учетные данные доступа к данным.

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  COLUMN_PERMISSION
  CELL_FILTER_PERMISSION
  NESTED_PERMISSION
  NESTED_CELL_PERMISSION

--parent-resource-arn (строка)

ARN ресурса представления.

--root-resource-arn (строка)

ARN ресурса корневого представления в цепочке вложенных представлений.

--supported-dialect (структура)

Структура, определяющая диалект и версию диалекта, используемые движком запросов.

Dialect -> (строка)

Диалект движка запросов.

DialectVersion -> (строка)

Версия диалекта движка запросов. Например, 3.0.0.

Краткая синтаксическая запись:

Dialect=string,DialectVersion=string

Синтаксис JSON:

{
  "Dialect": "REDSHIFT"|"ATHENA"|"SPARK",
  "DialectVersion": "string"
}

--permissions (список)

Разрешения Lake Formation на данные вызывающего пользователя для таблицы. Используются для авторизации вызова, когда контекст представления не найден.

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  ALL
  SELECT
  ALTER
  DROP
  DELETE
  INSERT
  CREATE_DATABASE
  CREATE_TABLE
  DATA_LOCATION_ACCESS

--query-session-context (структура)

Структура, используемая в качестве протокола между движками запросов и Lake Formation или Glue. Содержит как идентификатор авторизации, сгенерированный Lake Formation, так и информацию из контекста авторизации запроса.

QueryId -> (строка)

Уникальный идентификатор, сгенерированный движком запросов для запроса.

QueryStartTime -> (метка времени)

Метка времени, предоставленная движком запросов для времени начала запроса.

ClusterId -> (строка)

Строка-идентификатор для кластера потребителя.

QueryAuthorizationId -> (строка)

Криптографически сгенерированный идентификатор запроса, сгенерированный Glue или Lake Formation.

AdditionalContext -> (карта)

Непрозрачная карта строка-строка, переданная движком запросов.

key -> (строка)

value -> (строка)

Краткая синтаксическая запись:

QueryId=string,QueryStartTime=timestamp,ClusterId=string,QueryAuthorizationId=string,AdditionalContext={KeyName1=string,KeyName2=string}

Синтаксис JSON:

{
  "QueryId": "string",
  "QueryStartTime": timestamp,
  "ClusterId": "string",
  "QueryAuthorizationId": "string",
  "AdditionalContext": {"string": "string"
    ...}
}

--resource-region (строка)

Указывается только если базовые таблицы принадлежат другому региону Amazon Web Services.

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределят значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения, используя значение, предоставленное JSON, так как строка будет воспринята буквально. Это может не быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено значение без значения или значение input, выводит пример JSON-ввода, который может использоваться в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, выведет пример YAML-ввода, который можно использовать с --cli-input-yaml. Если предоставлено значение output, валидирует входные данные команды и возвращает пример JSON-вывода для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (булево)

Включение отладки регистрации.

--endpoint-url (строка)

Переопределение URL по умолчанию команды указанным URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого соединения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет стандартное поведение проверки сертификатов SSL.

--no-paginate (булево)

Отключение автоматической постраничной навигации. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования для вывода команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использование определенного профиля из файла учетных данных.

--region (строка)

Используемый регион. Переопределяет настройки конфигурации/среды.

--version (строка)

Вывод версии этого инструмента.

--color (строка)

Включение/выключение цветного вывода.

  • on
  • off
  • auto

--no-sign-request (булево)

Отключение подписи запросов. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Файл сертификатов CA для использования при проверке сертификатов SSL. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время соединения сокета в секундах. Если значение установлено в 0, соединение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию - base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображаемого в двоичный блок, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла непосредственно, независимо от настройки cli-binary-format. При использовании file:// содержимое файла необходимо правильно отформатировать для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (булево)

Отключение пейджера cli для вывода.

--cli-auto-prompt (булево)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (булево)

Отключить автоматический запрос параметров ввода CLI.

Вывод

Таблица -> (структура)

Объект Таблица, содержащий метаданные о таблице.

Имя -> (строка)

Имя таблицы. Для совместимости с Hive, оно должно быть полностью в нижнем регистре.

ИмяБД -> (строка)

Имя базы данных, в которой находятся метаданные о таблице. Для совместимости с Hive, оно должно быть полностью в нижнем регистре.

Описание -> (строка)

Описание таблицы.

Владелец -> (строка)

Владелец таблицы.

ВремяСоздание -> (метка времени)

Время создания определения таблицы в Каталоге данных.

ВремяОбновления -> (метка времени)

Последнее время обновления таблицы.

ПоследнееВремяДоступа -> (метка времени)

Последнее время доступа к таблице. Обычно берется из HDFS и может быть ненадёжным.

ПоследнееВремяАнализа -> (метка времени)

Последнее время вычисления статистики колонок для этой таблицы.

СрокХранения -> (целое число)

Срок хранения этой таблицы.

ОписаниеХранения -> (структура)

Описание хранения, содержащее информацию о физическом хранении этой таблицы.

Колонки -> (список)

Список Columns в таблице.

(структура)

Столбец в Table.

Имя -> (строка)

Имя Column.

Тип -> (строка)

Тип данных Column.

Комментарий -> (строка)

Текстовый комментарий произвольной формы.

Параметры -> (словарь)

Эти пары ключ-значение определяют свойства, связанные со столбцом.

ключ -> (строка)

значение -> (строка)

Расположение -> (строка)

Физическое расположение таблицы. По умолчанию это расположение хранилища, далее расположение базы данных в хранилище и, наконец, имя таблицы.

ДополнительныеРасположения -> (список)

Список расположений, указывающих на путь, где расположена таблица Delta.

(строка)

ФорматВвода -> (строка)

Формат ввода: SequenceFileInputFormat (двоичный) или TextInputFormat или пользовательский формат.

ФорматВывода -> (строка)

Формат вывода: SequenceFileOutputFormat (двоичный) или IgnoreKeyTextOutputFormat или пользовательский формат.

Сжато -> (булево)

True, если данные в таблице сжаты, или False, если нет.

КоличествоБакет -> (целое число)

Должно быть указано, если таблица содержит какие-либо столбцы измерений.

ИнформацияОСериализации -> (структура)

Информация о сериализации/десериализации (SerDe).

Имя -> (строка)

Имя SerDe.

БиблиотекаСериализации -> (строка)

Обычно класс, реализующий SerDe. Пример - org.apache.hadoop.hive.serde2.columnar.ColumnarSerDe.

Параметры -> (словарь)

Эти пары ключ-значение определяют параметры инициализации для SerDe.

ключ -> (строка)

значение -> (строка)

СтолбцыБакет -> (список)

Список столбцов группировки редуктора, столбцов кластеризации и столбцов бакет в таблице.

(строка)

СтолбцыСортировки -> (список)

Список, определяющий порядок сортировки каждого бакет в таблице.

(структура)

Определяет порядок сортировки отсортированного столбца.

Столбец -> (строка)

Имя столбца.

ПорядокСортировки -> (целое число)

Указывает, что столбец отсортирован в порядке возрастания (== 1) или убывания (==0).

Параметры -> (словарь)

Пользовательские свойства в формате ключ-значение.

ключ -> (строка)

значение -> (строка)

ИнформацияОНестандартныхЗначениях -> (структура)

Информация о значениях, которые часто встречаются в столбце (нестандартные значения).

ИменаСтолбцовСНестандартнымиЗначениями -> (список)

Список имен столбцов, содержащих нестандартные значения.

(строка)

НестандартныеЗначенияСтолбцов -> (список)

Список значений, которые встречаются так часто, что считаются нестандартными.

(строка)

КартыСопоставленийНестандартныхЗначенийСтолбцов -> (словарь)

Сопоставление нестандартных значений с столбцами, которые их содержат.

ключ -> (строка)

значение -> (строка)

ХранениеВПоддиректориях -> (булево)

True, если данные таблицы хранятся в поддиректориях, или False, если нет.

СсылкаНаСхему -> (структура)

Объект, ссылающийся на схему, хранящуюся в Реестре схем Glue.

При создании таблицы вы можете передать пустой список столбцов для схемы и вместо этого использовать ссылку на схему.

ИдентификаторСхемы -> (структура)

Структура, содержащая поля идентификации схемы. Должен быть указан либо этот, либо SchemaVersionId.

ARNСхемы -> (строка)

Amazon Resource Name (ARN) схемы. Должен быть указан либо SchemaArn, либо SchemaName.

ИмяСхемы -> (строка)

Имя схемы. Должен быть указан либо SchemaArn, либо SchemaName.

ИмяРеестра -> (строка)

Имя реестра схем, содержащего схему.

ИдентификаторВерсииСхемы -> (строка)

Уникальный идентификатор, присвоенный версии схемы. Должен быть указан либо этот, либо SchemaId.

НомерВерсииСхемы -> (длинное целое число)

Номер версии схемы.

КлючиРазбиения -> (список)

Список столбцов, по которым разбивается таблица. В качестве ключей разбиения поддерживаются только примитивные типы.

При создании таблицы, используемой Amazon Athena, и если вы не указываете никаких partitionKeys, вы должны хотя бы установить значение partitionKeys в пустой список. Например:

"PartitionKeys": []

(структура)

Столбец в Table.

Имя -> (строка)

Имя Column.

Тип -> (строка)

Тип данных Column.

Комментарий -> (строка)

Текстовый комментарий произвольной формы.

Параметры -> (словарь)

Эти пары ключ-значение определяют свойства, связанные со столбцом.

ключ -> (строка)

значение -> (строка)

ПросмотретьИсходныйТекст -> (строка)

Включено для совместимости с Apache Hive. Не используется в стандартных операциях Glue. Если таблица является VIRTUAL_VIEW, определённая конфигурация Athena кодируется в base64.

ПросмотретьРасширенныйТекст -> (строка)

Включено для совместимости с Apache Hive. Не используется в стандартных операциях Glue.

ТипТаблицы -> (строка)

Тип этой таблицы. Glue создаст таблицы типа EXTERNAL_TABLE. Другие сервисы, такие как Athena, могут создавать таблицы с дополнительными типами.

Типы таблиц, связанные с Glue:

EXTERNAL_TABLE

Совместимый с Hive атрибут - указывает на не управляемую Hive таблицу.

GOVERNED

Используется Lake Formation. Каталог данных Glue понимает GOVERNED.

Параметры -> (словарь)

Эти пары ключ-значение определяют свойства, связанные с таблицей.

ключ -> (строка)

значение -> (строка)

Создано -> (строка)

Человек или сущность, создавшая таблицу.

ЗарегистрированаВLakeFormation -> (булево)

Указывает, зарегистрирована ли таблица в Lake Formation.

ЦелеваяТаблица -> (структура)

Структура TableIdentifier, описывающая целевую таблицу для связывания ресурсов.

ИдентификаторКаталога -> (строка)

Идентификатор Каталога данных, в котором находится таблица.

ИмяБазыДанных -> (строка)

Имя базы данных каталога, содержащей целевую таблицу.

Имя -> (строка)

Имя целевой таблицы.

Регион -> (строка)

Регион целевой таблицы.

ИдентификаторКаталога -> (строка)

Идентификатор Каталога данных, в котором находится таблица.

ИдентификаторВерсии -> (строка)

Идентификатор версии таблицы.

ФедеративнаяТаблица -> (структура)

Структура FederatedTable, которая ссылается на сущность за пределами Каталога данных Glue.

Идентификатор -> (строка)

Уникальный идентификатор федеративной таблицы.

ИдентификаторБазыДанных -> (строка)

Уникальный идентификатор федеративной базы данных.

ИмяПодключения -> (строка)

Имя подключения к внешнему метастору.

ОпределениеПредставления -> (структура)

Структура, содержащая всю информацию, определяющую представление, включая диалект(ы) для представления и запрос.

Защищена -> (булево)

Вы можете установить этот флаг в значение true, чтобы указать движку не вставлять пользовательские операции в логический план представления во время планирования запроса. Однако, установка этого флага не гарантирует, что движок будет этому следовать. Обратитесь к документации движка, чтобы понять предоставляемые, если таковые имеются, гарантии.

Определитель -> (строка)

Определитель представления в SQL.

Подобъекты -> (список)

Список Amazon Resource Names (ARN) таблиц.

(строка)

Представления -> (список)

Список представлений.

(структура)

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

Диалект -> (строка)

Диалект движка запросов.

ВерсияДиалекта -> (строка)

Версия диалекта движка запросов. Например, 3.0.0.

ПросмотретьИсходныйТекст -> (строка)

Запрос SELECT, предоставленный клиентом во время CREATE VIEW DDL. Этот SQL не используется во время запроса к представлению (ViewExpandedText используется вместо этого). ViewOriginalText используется для случаев, подобных SHOW CREATE VIEW, где пользователи хотят увидеть исходную команду DDL, которая создала представление.

ПросмотретьРасширенныйТекст -> (строка)

Расширенный SQL для представления. Этот SQL используется движками при обработке запроса к представлению. Движки могут выполнять операции во время создания представления, чтобы преобразовать ViewOriginalText в ViewExpandedText. Например:

  • Полностью квалифицированные идентификаторы: SELECT * from table1 -> SELECT * from db1.table1

ПодключениеДляПроверки -> (строка)

Имя подключения, которое будет использоваться для проверки конкретного представления представления.

Устарело -> (булево)

Диалекты, помеченные как устаревшие, больше не действительны и должны быть обновлены, прежде чем их можно будет запросить в соответствующих движках запросов.

МногоязыковоеПредставление -> (булево)

Указывает, поддерживает ли представление SQL диалекты одного или нескольких различных движков запросов и, следовательно, может быть прочитан этими движками.

Статус -> (структура)

Структура, содержащая информацию о состоянии асинхронного изменения таблицы.

RequestedBy -> (строка)

ARN пользователя, запросившего асинхронное изменение.

UpdatedBy -> (строка)

ARN пользователя, последним вручную изменившего асинхронное изменение (например, запросив отмену).

RequestTime -> (метка времени)

Строка даты в формате ISO 8601, указывающая время начала изменения.

UpdateTime -> (метка времени)

Строка даты в формате ISO 8601, указывающая время последнего обновления состояния.

Action -> (строка)

Указывает, какое действие было вызвано над таблицей, в настоящее время только CREATE или UPDATE.

State -> (строка)

Общий статус изменения в процессе, например, ОЧЕРЕДЬ, В_ПРОЦЕССЕ, УСПЕХ или НЕУДАЧА.

Error -> (структура)

Ошибка, которая будет отображаться только при состоянии «НЕУДАЧА». Это сообщение об ошибке родительского уровня, могут быть разные Error для каждого диалекта.

ErrorCode -> (строка)

Код, связанный с этой ошибкой.

ErrorMessage -> (строка)

Сообщение, описывающее ошибку.

Details -> (структура)

Объект StatusDetails с информацией о запрошенном изменении.

RequestedChange -> (структура)

Объект Table, представляющий запрошенные изменения.

Name -> (строка)

Имя таблицы. Для совместимости с Hive, оно должно быть полностью в нижнем регистре.

DatabaseName -> (строка)

Имя базы данных, в которой хранятся метаданные таблицы. Для совместимости с Hive, оно должно быть полностью в нижнем регистре.

Description -> (строка)

Описание таблицы.

Owner -> (строка)

Владелец таблицы.

CreateTime -> (отметка времени)

Время создания определения таблицы в каталоге данных.

UpdateTime -> (отметка времени)

Последнее время обновления таблицы.

LastAccessTime -> (отметка времени)

Последнее время доступа к таблице. Обычно берётся из HDFS и может быть ненадёжным.

LastAnalyzedTime -> (отметка времени)

Последнее время вычисления статистики столбцов для этой таблицы.

Retention -> (целое число)

Время хранения для этой таблицы.

StorageDescriptor -> (структура)

Описание хранилища, содержащее информацию о физическом хранении этой таблицы.

Columns -> (список)

Список Columns в таблице.

(структура)

Столбец в Table.

Name -> (строка)

Имя Column.

Type -> (строка)

Тип данных Column.

Comment -> (строка)

Текстовый комментарий.

Parameters -> (карта)

Эти пары ключ-значение определяют свойства, связанные со столбцом.

key -> (строка)

value -> (строка)

Location -> (строка)

Физическое расположение таблицы. По умолчанию, это путь к хранилищу, затем к базе данных в хранилище и, наконец, к имени таблицы.

AdditionalLocations -> (список)

Список расположений, указывающих на путь, где расположена таблица Delta.

(строка)

InputFormat -> (строка)

Формат ввода: SequenceFileInputFormat (двоичный), или IgnoreKeyTextOutputFormat, или пользовательский формат.

OutputFormat -> (строка)

Формат вывода: SequenceFileOutputFormat (двоичный), или IgnoreKeyTextOutputFormat, или пользовательский формат.

Compressed -> (булево)

True, если данные в таблице сжаты, или False, если нет.

NumberOfBuckets -> (целое число)

Должно быть указано, если таблица содержит столбцы измерения.

SerdeInfo -> (структура)

Информация о сериализации/десериализации (SerDe).

Name -> (строка)

Имя SerDe.

SerializationLibrary -> (строка)

Обычно класс, реализующий SerDe. Пример — org.apache.hadoop.hive.serde2.columnar.ColumnarSerDe.

Parameters -> (карта)

Эти пары ключ-значение определяют параметры инициализации для SerDe.

key -> (строка)

value -> (строка)

BucketColumns -> (список)

Список столбцов группирования редуктора, столбцов кластеризации и столбцов букетирования в таблице.

(строка)

SortColumns -> (список)

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

(структура)

Определяет порядок сортировки столбца.

Column -> (строка)

Имя столбца.

SortOrder -> (целое число)

Указывает, что столбец отсортирован в порядке возрастания (== 1) или в порядке убывания (==0).

Parameters -> (карта)

Пользовательские свойства в формате ключ-значение.

key -> (строка)

value -> (строка)

SkewedInfo -> (структура)

Информация о значениях, часто встречающихся в столбце (значения, склонные к искажению).

SkewedColumnNames -> (список)

Список имён столбцов, содержащих значения, склонные к искажению.

(строка)

SkewedColumnValues -> (список)

Список значений, настолько часто встречающихся, что считаются искажающими.

(строка)

SkewedColumnValueLocationMaps -> (карта)

Сопоставление искажающих значений с столбцами, их содержащими.

key -> (строка)

value -> (строка)

StoredAsSubDirectories -> (булево)

True, если данные таблицы хранятся в подкаталогах, или False, если нет.

SchemaReference -> (структура)

Объект, ссылающийся на схему, хранящуюся в реестре схем Glue.

При создании таблицы вы можете передать пустой список столбцов для схемы и вместо этого использовать ссылку на схему.

SchemaId -> (структура)

Структура, содержащая поля идентификации схемы. Либо это, либо SchemaVersionId должны быть указаны.

SchemaArn -> (строка)

Amazon Resource Name (ARN) схемы. Должен быть указан один из SchemaArn или SchemaName.

SchemaName -> (строка)

Имя схемы. Должен быть указан один из SchemaArn или SchemaName.

RegistryName -> (строка)

Имя реестра схем, содержащего схему.

SchemaVersionId -> (строка)

Уникальный идентификатор, присвоенный версии схемы. Либо это, либо SchemaId должны быть указаны.

SchemaVersionNumber -> (длинное целое число)

Номер версии схемы.

PartitionKeys -> (список)

Список столбцов, по которым таблица разделена. Только примитивные типы поддерживаются в качестве ключей разделения.

Когда вы создаёте таблицу, используемую Amazon Athena, и не указываете никаких partitionKeys, вы должны по крайней мере установить значение partitionKeys в пустой список. Например:

"PartitionKeys": []

(структура)

Столбец в Table.

Name -> (строка)

Имя Column.

Type -> (строка)

Тип данных Column.

Comment -> (строка)

Текстовый комментарий.

Parameters -> (карта)

Эти пары ключ-значение определяют свойства, связанные со столбцом.

key -> (строка)

value -> (строка)

ViewOriginalText -> (строка)

Включено для совместимости с Apache Hive. Не используется в обычных операциях Glue. Если таблица — VIRTUAL_VIEW, определённая конфигурация Athena в base64.

ViewExpandedText -> (строка)

Включено для совместимости с Apache Hive. Не используется в обычных операциях Glue.

TableType -> (строка)

Тип этой таблицы. Glue создаёт таблицы типа EXTERNAL_TABLE. Другие сервисы, такие как Athena, могут создавать таблицы с дополнительными типами таблиц.

Типы таблиц, связанные с Glue:

EXTERNAL_TABLE

Совместимый с Hive атрибут — указывает на таблицу, не управляемую Hive.

GOVERNED

Используется Lake Formation. Каталог данных Glue понимает GOVERNED.

Parameters -> (карта)

Эти пары ключ-значение определяют свойства, связанные с таблицей.

key -> (строка)

value -> (строка)

CreatedBy -> (строка)

Лицо или сущность, создавшая таблицу.

IsRegisteredWithLakeFormation -> (булево)

Указывает, зарегистрирована ли таблица в Lake Formation.

TargetTable -> (структура)

Структура TableIdentifier, описывающая целевую таблицу для привязки ресурсов.

CatalogId -> (строка)

Идентификатор каталога данных, в котором находится таблица.

DatabaseName -> (строка)

Имя базы данных каталога, содержащей целевую таблицу.

Name -> (строка)

Имя целевой таблицы.

Region -> (строка)

Регион целевой таблицы.

CatalogId -> (строка)

Идентификатор каталога данных, в котором находится таблица.

VersionId -> (строка)

Идентификатор версии таблицы.

FederatedTable -> (структура)

Структура FederatedTable, ссылающаяся на сущность за пределами каталога данных Glue.

Identifier -> (строка)

Уникальный идентификатор федеративной таблицы.

DatabaseIdentifier -> (строка)

Уникальный идентификатор федеративной базы данных.

ConnectionName -> (строка)

Имя подключения к внешнему метахранилищу.

ViewDefinition -> (структура)

Структура, содержащая всю информацию, определяющую представление, включая диалект или диалекты для представления и запрос.

IsProtected -> (булево)

Вы можете установить этот флаг в значение true, чтобы указать движку не добавлять операции пользователя в логический план представления во время планирования запросов. Однако установка этого флага не гарантирует, что движок будет следовать этому. Обратитесь к документации движка, чтобы понять предоставленные гарантии, если таковые имеются.

Definer -> (строка)

Определяющий запрос представления в SQL.

SubObjects -> (список)

Список Amazon Resource Names (ARN) таблиц.

(строка)

Representations -> (список)

Список представлений.

(структура)

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

Dialect -> (строка)

Диалект движка запросов.

DialectVersion -> (строка)

Версия диалекта движка запросов. Например, 3.0.0.

ViewOriginalText -> (строка)

Запрос SELECT, предоставленный клиентом во время CREATE VIEW DDL. Этот SQL не используется при запросе к представлению (вместо этого используется ViewExpandedText). ViewOriginalText используется для случаев, таких как SHOW CREATE VIEW, когда пользователи хотят увидеть исходную команду DDL, создающую представление.

ViewExpandedText -> (строка)

Расширенный SQL для представления. Этот SQL используется движками при обработке запроса к представлению. Движки могут выполнять операции при создании представления для преобразования ViewOriginalText в ViewExpandedText. Например:

  • Полные квалифицированные идентификаторы: SELECT * from table1 -> SELECT * from db1.table1

ValidationConnection -> (строка)

Имя подключения, используемого для проверки конкретного представления представления.

IsStale -> (булево)

Диалекты, помеченные как устаревшие, больше недействительны и должны быть обновлены, прежде чем они смогут быть запрошены в соответствующих движках запросов.

IsMultiDialectView -> (булево)

Указывает, поддерживает ли представление диалекты SQL одного или нескольких различных движков запросов и, следовательно, может быть прочитан этими движками.

Status -> (структура)

Структура, содержащая информацию о состоянии асинхронного изменения таблицы.

RequestedBy -> (строка)

ARN пользователя, запросившего асинхронное изменение.

UpdatedBy -> (строка)

ARN пользователя, последним вручную изменившего асинхронное изменение (запрос отмены и т. д.).

RequestTime -> (метка времени)

Строка даты в формате ISO 8601, указывающая время инициирования изменения.

UpdateTime -> (метка времени)

Строка даты в формате ISO 8601, указывающая время последнего обновления состояния.

Action -> (строка)

Указывает вызвавшее действие над таблицей, в настоящее время только CREATE или UPDATE.

State -> (строка)

Общий статус изменения в процессе, например, ОЧЕРЕДЬ, В_ПРОЦЕССЕ, УСПЕХ или НЕУДАЧА.

Error -> (структура)

Ошибка, которая появится только при состоянии «НЕУДАЧА». Это сообщение об ошибке родительского уровня, могут быть разные Error для каждого диалекта.

ErrorCode -> (строка)

Код, связанный с этой ошибкой.

ErrorMessage -> (строка)

Сообщение, описывающее ошибку.

Details -> (структура)

Объект StatusDetails с информацией об запрошенном изменении.

(… рекурсивно …)ViewValidations -> (список)

Список объектов ViewValidation, содержащих информацию для аналитического движка для проверки представления.

(структура)

Структура, содержащая информацию для аналитического движка для проверки представления перед сохранением метаданных представления. Используется в случае прямых UpdateTable или CreateTable API-вызовов.

Dialect -> (строка)

Диалект движка запросов.

DialectVersion -> (строка)

Версия диалекта движка запросов. Например, 3.0.0.

ViewValidationText -> (строка)

Запрос SELECT, определяющий представление, предоставленный клиентом.

UpdateTime -> (метка времени)

Время последнего обновления.

State -> (строка)

Состояние проверки.

Error -> (структура)

Ошибка, связанная с проверкой.

ErrorCode -> (строка)

Код, связанный с этой ошибкой.

ErrorMessage -> (строка)

Сообщение, описывающее ошибку.

ViewValidations -> (список)

Список объектов ViewValidation, содержащих информацию для аналитического движка для проверки представления.

(структура)

Структура, содержащая информацию для аналитического движка для проверки представления перед сохранением метаданных представления. Используется в случае прямых UpdateTable или CreateTable API-вызовов.

Dialect -> (строка)

Диалект движка запросов.

DialectVersion -> (строка)

Версия диалекта движка запросов. Например, 3.0.0.

ViewValidationText -> (строка)

Запрос SELECT, определяющий представление, предоставленный клиентом.

UpdateTime -> (метка времени)

Время последнего обновления.

State -> (строка)

Состояние проверки.

Error -> (структура)

Ошибка, связанная с проверкой.

ErrorCode -> (строка)

Код, связанный с этой ошибкой.

ErrorMessage -> (строка)

Сообщение, описывающее ошибку.

AuthorizedColumns -> (список)

Список имён столбцов, к которым пользователю предоставлен доступ.

(строка)

IsRegisteredWithLakeFormation -> (булево)

Булевое значение, указывающее, зарегистрирован ли расположение раздела с Lake Formation.

CellFilters -> (список)

Список фильтров строк столбцов.

(структура)

Фильтр, использующий фильтрацию на уровне столбца и строки.

ColumnName -> (строка)

Строка, содержащая имя столбца.

RowFilterExpression -> (строка)

Строка, содержащая выражение фильтра строк.

QueryAuthorizationId -> (строка)

Криптографически сгенерированный идентификатор запроса, сгенерированный Glue или Lake Formation.

IsMultiDialectView -> (булево)

Указывает, поддерживает ли представление SQL-диалекты одного или нескольких различных движков запросов и может ли оно поэтому читаться этими движками.

ResourceArn -> (строка)

ARN ресурса родительского ресурса, извлечённого из запроса.

IsProtected -> (булево)

Флаг, который инструктирует движок не помещать предоставленные пользователем операции в логический план представления при планировании запроса. Однако, если установлен этот флаг, это не гарантирует, что движок будет соответствовать. Обратитесь к документации движка, чтобы понять предоставляемые гарантии, если таковые имеются.

Permissions -> (список)

Разрешения Lake Formation для данных вызывающего абонента на таблице. Используется для авторизации вызова, когда контекст представления не найден.

(строка)

RowFilter -> (строка)

Фильтр, применяемый к таблице. Например, при применении фильтра в SQL он будет находиться в WHERE-оператор и может оцениваться с использованием AND оператора с любыми другими предикатами, применёнными пользователем, запрашивающим таблицу.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API