Spec-Zone.ru › AWS CLI v2

[ aws . glue ]

create-catalog

Описание

Создаёт новый каталог в каталоге данных Glue.

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

Синтаксис

  create-catalog
--name <value>
--catalog-input <value>
[--tags <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]

Параметры

--name (строка)

Имя создаваемого каталога.

--catalog-input (структура)

Объект CatalogInput, определяющий метаданные каталога.

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

Строка описания, не более 2048 байт, соответствующая шаблону многострочной строки URI. Описание каталога.

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

Объект FederatedCatalog. Структура FederatedCatalog, которая ссылается на сущность за пределами каталога данных Glue, например, базу данных Redshift.

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

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

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

Имя подключения к внешнему источнику данных, например, к федеративному каталогу Redshift.

Параметры -> (массив)

Массив пар ключ-значение, определяющих параметры и свойства каталога.

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

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

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

Объект TargetRedshiftCatalog, описывающий целевой каталог для связывания ресурсов.

CatalogArn -> (строка)

Идентификатор ресурса каталога Amazon Resource Name (ARN).

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

Объект CatalogProperties, задающий свойства доступа к хранилищу данных и другие пользовательские свойства.

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

Объект DataLakeAccessProperties, определяющий свойства для настройки доступа к хранилищу данных для вашего каталога ресурсов в каталоге данных Glue.

DataLakeAccess -> (логическое значение)

Включает или отключает доступ к хранилищу данных для приложений Apache Spark, которые обращаются к базам данных Amazon Redshift в каталоге данных из любого движка, отличного от Redshift, например, Amazon Athena, Amazon EMR или Glue ETL.

DataTransferRole -> (строка)

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

KmsKey -> (строка)

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

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

Задает тип федеративного каталога для нативного каталога ресурсов. В настоящее время поддерживается тип aws:redshift.

CustomProperties -> (массив)

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

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

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

CreateTableDefaultPermissions -> (список)

Массив объектов PrincipalPermissions. Создаёт набор стандартных разрешений на таблицу(ы) для субъектов. Используется Amazon Web Services Lake Formation. Обычно должен быть явно установлен как пустой список.

(структура)

Разрешения, предоставленные субъекту.

Субъект -> (структура)

Субъект, которому предоставляются разрешения.

DataLakePrincipalIdentifier -> (строка)

Идентификатор субъекта Lake Formation.

Разрешения -> (список)

Разрешения, предоставляемые субъекту.

(строка)

CreateDatabaseDefaultPermissions -> (список)

Массив объектов PrincipalPermissions. Создаёт набор стандартных разрешений на базу данных(ы) для субъектов. Используется Amazon Web Services Lake Formation. Обычно должен быть явно установлен как пустой список.

(структура)

Разрешения, предоставленные субъекту.

Субъект -> (структура)

Субъект, которому предоставляются разрешения.

DataLakePrincipalIdentifier -> (строка)

Идентификатор субъекта Lake Formation.

Разрешения -> (список)

Разрешения, предоставляемые субъекту.

(строка)

AllowFullTableExternalDataAccess -> (строка)

Разрешает сторонним движкам доступ к данным в расположениях Amazon S3, зарегистрированных в Lake Formation.

Синтаксис JSON:

{
  "Description": "string",
  "FederatedCatalog": {
    "Identifier": "string",
    "ConnectionName": "string"
  },
  "Parameters": {"string": "string"
    ...},
  "TargetRedshiftCatalog": {
    "CatalogArn": "string"
  },
  "CatalogProperties": {
    "DataLakeAccessProperties": {
      "DataLakeAccess": true|false,
      "DataTransferRole": "string",
      "KmsKey": "string",
      "CatalogType": "string"
    },
    "CustomProperties": {"string": "string"
      ...}
  },
  "CreateTableDefaultPermissions": [
    {
      "Principal": {
        "DataLakePrincipalIdentifier": "string"
      },
      "Permissions": ["ALL"|"SELECT"|"ALTER"|"DROP"|"DELETE"|"INSERT"|"CREATE_DATABASE"|"CREATE_TABLE"|"DATA_LOCATION_ACCESS", ...]
    }
    ...
  ],
  "CreateDatabaseDefaultPermissions": [
    {
      "Principal": {
        "DataLakePrincipalIdentifier": "string"
      },
      "Permissions": ["ALL"|"SELECT"|"ALTER"|"DROP"|"DELETE"|"INSERT"|"CREATE_DATABASE"|"CREATE_TABLE"|"DATA_LOCATION_ACCESS", ...]
    }
    ...
  ],
  "AllowFullTableExternalDataAccess": "True"|"False"
}

--tags (массив)

Массив пар ключ-значение, не более 50 пар. Каждый ключ — строка UTF-8, не менее 1 и не более 128 байт. Каждое значение — строка UTF-8, не более 256 байт. Теги, которые вы назначаете каталогу.

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

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

Сокращённый синтаксис:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--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
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

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

  • включено
  • выключено
  • автоматически

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

Вывод

Нет

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

Spec-Zone.ru

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