Spec-Zone.ru › AWS CLI v2

[ aws . glue ]

get-tables

Описание

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

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

get-tables — это операция с постраничной передачей. Для извлечения всего набора результатов могут потребоваться несколько вызовов API. Вы можете отключить постраничную передачу, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной передачей аргумент --query должен извлекать данные из результатов следующих выражений запроса: TableList

Синтаксис

  get-tables
[--catalog-id <value>]
--database-name <value>
[--expression <value>]
[--transaction-id <value>]
[--query-as-of-time <value>]
[--include-status-details | --no-include-status-details]
[--attributes-to-get <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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 (строка)

Идентификатор каталога данных, в котором находятся таблицы. Если не указан, используется идентификатор учетной записи Amazon Web Services по умолчанию.

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

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

--expression (строка)

Шаблон регулярного выражения. Если указан, возвращаются только те таблицы, имена которых соответствуют шаблону.

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

Идентификатор транзакции, по которому нужно прочитать содержимое таблицы.

--query-as-of-time (метка времени)

Время, по состоянию на которое необходимо прочитать содержимое таблицы. Если не задано, используется время последнего подтверждения транзакции. Не может быть указано вместе с TransactionId.

--include-status-details | --no-include-status-details (булево)

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

--attributes-to-get (список)

Указывает поля таблиц, возвращаемые вызовом GetTables. Этот параметр не допускает пустой список. Запрос должен включать NAME.

Следующие комбинации значений допустимы:

  • NAME - Имена всех таблиц в базе данных.
  • NAME , TABLE_TYPE - Имена всех таблиц и типы таблиц.

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  NAME
  TABLE_TYPE

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

--starting-token (строка)

Токен для указания точки начала постраничной обработки. Это NextToken из ранее усеченного ответа.

Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, извлекая меньше элементов в каждом вызове. Это может помочь предотвратить временные ограничения вызовов AWS-сервиса.

Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов, которые нужно вернуть в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды предоставляется NextToken. Чтобы продолжить постраничную обработку, укажите значение NextToken в аргументе starting-token последующей команды. **Не** используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.

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

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

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 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.

Примеры

Примечание

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

Если не указано иное, все примеры используют правила цитирования типа Unix. Эти примеры нужно адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

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

Следующий пример get-tables возвращает информацию о таблицах в указанной базе данных.

aws glue get-tables --database-name 'tempdb'

Вывод:

{
    "TableList": [
        {
            "Name": "my-s3-sink",
            "DatabaseName": "tempdb",
            "CreateTime": 1602730539.0,
            "UpdateTime": 1602730539.0,
            "Retention": 0,
            "StorageDescriptor": {
                "Columns": [
                    {
                        "Name": "sensorid",
                        "Type": "int"
                    },
                    {
                        "Name": "currenttemperature",
                        "Type": "int"
                    },
                    {
                        "Name": "status",
                        "Type": "string"
                    }
                ],
                "Location": "s3://janetst-bucket-01/test-s3-output/",
                "Compressed": false,
                "NumberOfBuckets": 0,
                "SerdeInfo": {
                    "SerializationLibrary": "org.openx.data.jsonserde.JsonSerDe"
                },
                "SortColumns": [],
                "StoredAsSubDirectories": false
            },
            "Parameters": {
                "classification": "json"
            },
            "CreatedBy": "arn:aws:iam::007436865787:user/JRSTERN",
            "IsRegisteredWithLakeFormation": false,
            "CatalogId": "007436865787"
        },
        {
            "Name": "s3-source",
            "DatabaseName": "tempdb",
            "CreateTime": 1602730658.0,
            "UpdateTime": 1602730658.0,
            "Retention": 0,
            "StorageDescriptor": {
                "Columns": [
                    {
                        "Name": "sensorid",
                        "Type": "int"
                    },
                    {
                        "Name": "currenttemperature",
                        "Type": "int"
                    },
                    {
                        "Name": "status",
                        "Type": "string"
                    }
                ],
                "Location": "s3://janetst-bucket-01/",
                "Compressed": false,
                "NumberOfBuckets": 0,
                "SortColumns": [],
                "StoredAsSubDirectories": false
            },
            "Parameters": {
                "classification": "json"
            },
            "CreatedBy": "arn:aws:iam::007436865787:user/JRSTERN",
            "IsRegisteredWithLakeFormation": false,
            "CatalogId": "007436865787"
        },
        {
            "Name": "test-kinesis-input",
            "DatabaseName": "tempdb",
            "CreateTime": 1601507001.0,
            "UpdateTime": 1601507001.0,
            "Retention": 0,
            "StorageDescriptor": {
                "Columns": [
                    {
                        "Name": "sensorid",
                        "Type": "int"
                    },
                    {
                        "Name": "currenttemperature",
                        "Type": "int"
                    },
                    {
                        "Name": "status",
                        "Type": "string"
                    }
                ],
                "Location": "my-testing-stream",
                "Compressed": false,
                "NumberOfBuckets": 0,
                "SerdeInfo": {
                    "SerializationLibrary": "org.openx.data.jsonserde.JsonSerDe"
                },
                "SortColumns": [],
                "Parameters": {
                    "kinesisUrl": "https://kinesis.us-east-1.amazonaws.com",
                    "streamName": "my-testing-stream",
                    "typeOfData": "kinesis"
                },
                "StoredAsSubDirectories": false
            },
            "Parameters": {
                "classification": "json"
            },
            "CreatedBy": "arn:aws:iam::007436865787:user/JRSTERN",
            "IsRegisteredWithLakeFormation": false,
            "CatalogId": "007436865787"
        }
    ]
}

Дополнительную информацию см. в разделе Определение таблиц в каталоге данных AWS Glue в Руководстве разработчика AWS Glue.

Вывод

TableList -> (список)

Список запрошенных 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 (двоичный), или TextInputFormat , или пользовательский формат.

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 Data Catalog понимает 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 с информацией об указанном изменении.

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 (двоичный), или TextInputFormat, или пользовательский формат.

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 Schema Registry.

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

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 Data Catalog понимает GOVERNED.

Parameters -> (карта)

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

key -> (строка)

value -> (строка)

CreatedBy -> (строка)

Создатель таблицы (человек или сущность).

IsRegisteredWithLakeFormation -> (булево)

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

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

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

CatalogId -> (строка)

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

DatabaseName -> (строка)

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

Name -> (строка)

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

Region -> (строка)

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

CatalogId -> (строка)

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

VersionId -> (строка)

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

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

Структура FederatedTable, которая ссылается на сущность вне Glue Data Catalog.

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 -> (строка)

Общий статус изменения в процессе, например, QUEUED, IN_PROGRESS, SUCCESS или FAILED.

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

Ошибка, которая появится только в случае состояния «FAILED». Это сообщение об ошибке родительского уровня, могут быть разные 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 -> (строка)

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

NextToken -> (строка)

Маркер продолжения, присутствует, если текущий фрагмент списка не последний.

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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