Spec-Zone.ru › AWS CLI v2

[ aws . neptune-graph ]

create-graph-using-import-task

Описание

Создает новую аналитическую базу данных Neptune и импортирует данные в неё, либо из Amazon Simple Storage Service (S3), либо из базы данных Neptune или снимка базы данных Neptune.

Данные могут быть загружены из файлов в S3 в формате Gremlin CSV или формате загрузки openCypher.

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

Синтаксис

  create-graph-using-import-task
--graph-name <value>
[--tags <value>]
[--public-connectivity | --no-public-connectivity]
[--kms-key-identifier <value>]
[--vector-search-configuration <value>]
[--replica-count <value>]
[--deletion-protection | --no-deletion-protection]
[--import-options <value>]
[--max-provisioned-memory <value>]
[--min-provisioned-memory <value>]
[--fail-on-error | --no-fail-on-error]
--source <value>
[--format <value>]
[--parquet-type <value>]
[--blank-node-handling <value>]
--role-arn <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]

Параметры

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

Имя новой аналитической базы данных Neptune, которое будет создано.

Имя должно содержать от 1 до 63 букв, цифр или дефисов, и начинаться с буквы. Оно не может оканчиваться дефисом или содержать два дефиса подряд. Допускаются только строчные буквы.

--tags (массив)

Добавляет метки метаданных к новой базе данных. Эти метки также могут быть использованы для отчётности по распределению затрат или в условии (Condition) в политике IAM.

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

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

Краткая синтаксическая форма:

KeyName1=string,KeyName2=string

Синтаксис JSON:

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

--public-connectivity | --no-public-connectivity (булево)

Указывает, может ли база данных быть доступной через Интернет. Весь доступ к базам данных авторизован с помощью IAM. (true для включения или false для выключения).

--kms-key-identifier (строка)

Указывает ключ KMS для шифрования данных, импортированных в новую базу данных.

--vector-search-configuration (структура)

Указывает количество измерений для векторных встраиваний, которые будут загружены в базу данных. Значение задаётся как значение dimension=. Макс. = 65 535

размерность -> (целое число)

Количество измерений.

Краткая синтаксическая форма:

dimension=integer

Синтаксис JSON:

{
  "dimension": integer
}

--replica-count (целое число)

Количество реплик в других зонах доступности для развертывания на новой базе данных после импорта. По умолчанию = 0, Мин. = 0, Макс. = 2.

Предупреждение

За каждую реплику применяются дополнительные платежи, эквивалентные выбранным m-NCU для базы данных.

--deletion-protection | --no-deletion-protection (булево)

Указывает, нужно ли включить защиту от удаления для базы данных. Базу данных нельзя удалить, если защита от удаления включена. (true или false).

--import-options (структура помеченных объединений)

Содержит параметры для управления процессом импорта. Например, если ключ failOnError установлен на значение false, то импорт пропускает проблемные данные и пытается продолжить (в то время как, если значение установлено на значение true, по умолчанию, или если оно опущено, операция импорта останавливается немедленно при возникновении ошибки).

Примечание

Это структура помеченных объединений. Можно задать только один из следующих верхнеуровневых ключей: neptune.

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

Параметры для импорта данных из базы данных Neptune.

s3ExportPath -> (строка)

Путь к ведру S3 для импорта данных.

s3ExportKmsKeyId -> (строка)

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

preserveDefaultVertexLabels -> (булево)

Аналитика Neptune поддерживает вершины без меток, и метки не назначаются, если явно не указаны. Neptune назначает метки по умолчанию, если явно не указаны. При импорте данных в Neptune Analytics метки вершин по умолчанию можно опустить, установив preserveDefaultVertexLabels в значение false. Обратите внимание, что если вершина имеет только метки по умолчанию и не имеет других свойств или рёбер, то вершина фактически не будет импортирована в Neptune Analytics, когда preserveDefaultVertexLabels установлено в значение false.

preserveEdgeIds -> (булево)

Аналитика Neptune в настоящее время не поддерживает пользовательские идентификаторы рёбер. Идентификаторы рёбер не импортируются по умолчанию. Они импортируются, если preserveEdgeIds установлено в значение true, и идентификаторы сохраняются как свойства отношений со свойством neptuneEdgeId.

Краткая синтаксическая форма:

neptune={s3ExportPath=string,s3ExportKmsKeyId=string,preserveDefaultVertexLabels=boolean,preserveEdgeIds=boolean}

Синтаксис JSON:

{
  "neptune": {
    "s3ExportPath": "string",
    "s3ExportKmsKeyId": "string",
    "preserveDefaultVertexLabels": true|false,
    "preserveEdgeIds": true|false
  }
}

--max-provisioned-memory (целое число)

Максимальное количество оптимизированных по памяти единиц ёмкости Neptune (m-NCU) для использования в базе данных. По умолчанию: 1024 или максимально допустимое значение для вашей учётной записи.

Если указаны минимальное и максимальное значения, конечное значение provisioned-memory будет выбрано в соответствии с фактическим размером импортированных данных. Если ни одно из значений не указано, используются 128 m-NCU.

--min-provisioned-memory (целое число)

Минимальное количество оптимизированных по памяти единиц ёмкости Neptune (m-NCU) для использования в базе данных. По умолчанию: 16

--fail-on-error | --no-fail-on-error (булево)

Если установлено значение true, задача останавливается при обнаружении ошибки импорта. Если установлено значение false, задача пропускает данные, которые вызвали ошибку, и продолжает выполняться, если это возможно.

--source (строка)

URL, определяющий расположение импортируемых данных. Это может быть путь Amazon S3 или конечная точка или снимок базы данных Neptune.

--format (строка)

Указывает формат импортируемых данных S3. Допустимые значения — CSV (формат Gremlin CSV), OPEN_CYPHER (формат загрузки openCypher) или ntriples (формат RDF n-triples).

Возможные значения:

  • CSV
  • OPEN_CYPHER
  • PARQUET
  • NTRIPLES

--parquet-type (строка)

Тип паркета задачи импорта.

Возможные значения:

  • COLUMNAR

--blank-node-handling (строка)

Метод обработки пустых узлов в наборе данных. В настоящее время поддерживается только convertToIri, означающее, что пустые узлы преобразуются в уникальные IRI во время загрузки. Должно быть указано, когда формат равен ntriples. Дополнительную информацию см. в разделе Обработка значений RDF.

Возможные значения:

  • convertToIri

--role-arn (строка)

ARN роли IAM, которая предоставляет доступ к импортируемым данным.

--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-auto-prompt (булево)

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

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

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

Вывод

graphId -> (строка)

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

taskId -> (строка)

Уникальный идентификатор задачи импорта.

source -> (строка)

URL, определяющий местоположение импортируемых данных. Может быть путем в Amazon S3, или может указывать на конечную точку или моментальный снимок базы данных Neptune.

format -> (строка)

Указывает формат данных S3, подлежащих импорту. Допустимые значения: CSV, определяющее формат Gremlin CSV, OPENCYPHER, определяющее формат загрузки openCypher, или ntriples, определяющее формат RDF n-triples.

parquetType -> (строка)

Тип parquet задачи импорта.

roleArn -> (строка)

ARN роли IAM, которая предоставит доступ к импортируемым данным.

status -> (строка)

Статус задачи импорта.

importOptions -> (структура помеченного объединения)

Содержит параметры управления процессом импорта. Например, если ключ failOnError установлен в значение false, импорт пропускает проблемные данные и пытается продолжить (в то время как при значении true, по умолчанию, или при отсутствии, операция импорта немедленно завершается при возникновении ошибки).

Примечание

Это структура помеченного объединения. Может быть установлен только один из следующих ключевых параметров верхнего уровня: neptune.

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

Параметры импорта данных из базы данных Neptune.

s3ExportPath -> (строка)

Путь к ведру S3, из которого импортируются данные.

s3ExportKmsKeyId -> (строка)

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

preserveDefaultVertexLabels -> (булево значение)

Neptune Analytics поддерживает вершины без меток, и метки не назначаются, если не указана явная метка. Neptune назначает метки по умолчанию, если явная метка не указана. При импорте данных в Neptune Analytics, метки вершин по умолчанию можно опустить, установив preserveDefaultVertexLabels в значение false. Обратите внимание, что если вершина имеет только метки по умолчанию и не имеет других свойств или ребер, то вершина фактически не будет импортирована в Neptune Analytics при установке preserveDefaultVertexLabels в значение false.

preserveEdgeIds -> (булево значение)

Neptune Analytics в настоящее время не поддерживает пользовательские идентификаторы ребер. Идентификаторы ребер по умолчанию не импортируются. Они импортируются, если preserveEdgeIds установлено в значение true, и идентификаторы сохраняются в виде свойств отношений с именем свойства neptuneEdgeId.

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

Spec-Zone.ru

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