azdata bdc config

Статья
05/30/2023

Применимо к: Azure Data CLI (azdata)

В следующей статье приводятся справочные сведения по командам sql в средстве azdata. Дополнительные сведения о других командах azdata см. в справочнике по azdata.

Команды

Команда	Описание
azdata bdc config init	Инициализирует профиль конфигурации кластера больших данных, который можно использовать с командой bdc create.
azdata bdc config list	Выводит список доступных профилей конфигурации.
azdata bdc config show	Выводит текущую конфигурацию кластера больших данных или конфигурацию из указанного локального файла, например custom/bdc.json.
azdata bdc config add	Добавляет значение для пути JSON в файле конфигурации.
azdata bdc config remove	Удаляет значение пути JSON в файле конфигурации.
azdata bdc config replace	Заменяет значение пути JSON в файле конфигурации.
azdata bdc config patch	Вносит исправление в файл конфигурации на основе файла исправления JSON.

azdata bdc config init

Инициализирует профиль конфигурации кластера больших данных, который можно использовать с командой bdc create. В аргументах можно указать определенный источник профиля конфигурации.

azdata bdc config init [--path -p] 
                       [--source -s]  
                       
[--force -f]  
                       
[--accept-eula -a]

Примеры

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

azdata bdc config init

Инициализация конфигурации кластера больших данных с аргументами; создает профиль конфигурации aks-dev-test в ./custom.

azdata bdc config init --source aks-dev-test --target custom

Необязательные параметры

`--path -p`

Путь к файлу, в который следует поместить профиль конфигурации; по умолчанию — <cwd>/custom.

`--source -s`

Источник профиля конфигурации ("kubeadm-dev-test", "kubeadm-prod", "openshift-prod", "aks-dev-test-ha", "aks-dev-test", "aro-dev-test", "openshift-dev-test", "aro-dev-test-ha").

`--force -f`

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

`--accept-eula -a`

Вы принимаете условия лицензии? [да/нет]. Если вы не хотите использовать этот аргумент, можно присвоить переменной среды ACCEPT_EULA значение "yes". Условия лицензии для этого продукта можно просмотреть по адресу https://aka.ms/eula-azdata-en.

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

`--debug`

Повышение уровня детализации журнала для включения всех журналов отладки.

`--help -h`

Отображение этого справочного сообщения и выход.

`--output -o`

Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json.

`--query -q`

Строка запроса JMESPath. Дополнительные сведения и примеры см. на сайте http://jmespath.org/.

`--verbose`

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

azdata bdc config list

Выводит список доступных профилей конфигурации для использования в bdc config init.

azdata bdc config list [--config-profile -c] 
                       [--type -t]  
                       
[--accept-eula -a]

Примеры

Выводит имена всех доступных профилей конфигурации.

azdata bdc config list

Выводит код JSON определенного профиля конфигурации.

azdata bdc config list --config-profile aks-dev-test

Необязательные параметры

`--config-profile -c`

Профиль конфигурации по умолчанию ("kubeadm-dev-test", "kubeadm-prod", "openshift-prod", "aks-dev-test-ha", "aks-dev-test", "aro-dev-test", "openshift-dev-test", "aro-dev-test-ha").

`--type -t`

Тип конфигурации, который следует просмотреть.

`--accept-eula -a`

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

`--debug`

Повышение уровня детализации журнала для включения всех журналов отладки.

`--help -h`

Отображение этого справочного сообщения и выход.

`--output -o`

Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json.

`--query -q`

Строка запроса JMESPath. Дополнительные сведения и примеры см. на сайте http://jmespath.org/.

`--verbose`

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

azdata bdc config show

Выводит текущую конфигурацию кластера больших данных или конфигурацию из указанного локального файла, например custom/bdc.json. Команда также может принимать только путь JSON, если нужно получить только раздел. Вы также можете указать целевой файл для вывода данных. Если целевой файл не указан, выходные данные выводятся в терминал.

azdata bdc config show [--config-file -c] 
                       [--target -t]  
                       
[--json-path -j]  
                       
[--force -f]

Примеры

Вывод конфигурации кластера больших данных в консоли

azdata bdc config show

В локальном файле конфигурации возвращается значение в конце простого пути к ключу JSON.

azdata bdc config show --config-file custom-config/bdc.json --json-path "metadata.name" --target section.json

В локальном файле конфигурации возвращаются ресурсы в составе службы

azdata bdc config show --config-file custom-config/bdc.json --json-path "$.spec.services.sql.resources" --target section.json

Необязательные параметры

`--config-file -c`

Путь к файлу конфигурации кластера больших данных, в который выполнен вход, если не требуется его конфигурация (то есть custom/bdc.json).

`--target -t`

Выходной файл, в котором следует сохранить результат. По умолчанию: направляется в stdout.

`--json-path -j`

Путь к ключу JSON, который указывает на требуемый раздел или значение из конфигурации, например key1.key2.key3. Используется язык запросов jsonpath (https://jsonpath.com/), например: -j '$.spec.pools[?(@.spec.type == "Master")]..endpoints'

`--force -f`

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

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

`--debug`

Повышение уровня детализации журнала для включения всех журналов отладки.

`--help -h`

Отображение этого справочного сообщения и выход.

`--output -o`

Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json.

`--query -q`

Строка запроса JMESPath. Дополнительные сведения и примеры см. на сайте http://jmespath.org/.

`--verbose`

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

azdata bdc config add

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

azdata bdc config add --path -p 
                      --json-values -j

Примеры

Пример 1. Добавление хранилища уровня управления

azdata bdc config add --path custom/control.json --json-values "spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}"

Необходимые параметры

`--path -p`

Путь к файлу с конфигурацией кластера больших данных, которую нужно задать, например custom/bdc.json

`--json-values -j`

Список пар "ключ–значение" с путями JSON и значениями: ключ1.подключ1=значение1,ключ2.подключ2=значение2. Вы можете указать значения JSON в коде, например key='{"тип":"кластер","имя":"тестовый-кластер"}', или предоставить путь к файлу, например key=./values.json. При добавлении не поддерживаются условные выражения. Если предоставляемое вами встроенное значение представляет собой пару "ключ/значение" с символами "=" и ",", необходимо экранировать эти символы. Например, key1="key2=val2,key3=val3". Примеры путей см. на сайте http://jsonpatch.com/. Для доступа к массиву необходимо указать индекс, например ключ.0=значение

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

`--debug`

Повышение уровня детализации журнала для включения всех журналов отладки.

`--help -h`

Отображение этого справочного сообщения и выход.

`--output -o`

Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json.

`--query -q`

Строка запроса JMESPath. Дополнительные сведения и примеры см. на сайте http://jmespath.org/.

`--verbose`

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

azdata bdc config remove

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

azdata bdc config remove --path -p 
                         --json-path -j

Примеры

Пример 1. Удаление хранилища уровня управления

azdata bdc config remove --path custom/control.json --json-path ".spec.storage"

Необходимые параметры

`--path -p`

Путь к файлу с конфигурацией кластера больших данных, которую нужно задать, например custom/bdc.json

`--json-path -j`

Список путей JSON на основе библиотеки jsonpatch, в котором перечислены значения, которые необходимо удалить, например: ключ.подключ1,ключ2.подключ2. При удалении не поддерживаются условные выражения. Примеры путей см. на сайте http://jsonpatch.com/. Для доступа к массиву необходимо указать индекс, например ключ.0=значение

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

`--debug`

Повышение уровня детализации журнала для включения всех журналов отладки.

`--help -h`

Отображение этого справочного сообщения и выход.

`--output -o`

Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json.

`--query -q`

Строка запроса JMESPath. Дополнительные сведения и примеры см. на сайте http://jmespath.org/.

`--verbose`

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

azdata bdc config replace

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

azdata bdc config replace --path -p 
                          --json-values -j

Примеры

Пример 1. Замена порта одной конечной точки (конечной точки контроллера)

azdata bdc config replace --path custom/control.json --json-values "$.spec.endpoints[?(@.name=="Controller")].port=30080"

Пример 2. Замена хранилища уровня управления

azdata bdc config replace --path custom/control.json --json-values "spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}"

Пример 3. Замена спецификации ресурса storage-0, включая реплики.

azdata bdc config replace --path custom/bdc.json --json-values "$.spec.resources.storage-0.spec={"replicas": 2,"storage": {"className": "managed-premium","size": "10Gi","accessMode": "ReadWriteOnce"},"type": "Storage"}"

Необходимые параметры

`--path -p`

Путь к файлу с конфигурацией кластера больших данных, которую нужно задать, например custom/bdc.json

`--json-values -j`

Список пар "ключ–значение" с путями JSON и значениями: ключ1.подключ1=значение1,ключ2.подключ2=значение2. Вы можете указать значения JSON в коде, например key='{"тип":"кластер","имя":"тестовый-кластер"}', или предоставить путь к файлу, например key=./values.json. При замене условные выражения поддерживаются посредством библиотеки jsonpath. Для этого путь должен начинаться с символа $. Это позволяет использовать условия, например, следующего вида: -j $.key1.key2[?(@.key3=='некотроеЗначение'].key4=value. Если предоставляемое вами встроенное значение представляет собой пару "ключ/значение" с символами "=" и ",", необходимо экранировать эти символы. Например, key1="key2=val2,key3=val3". Примеры приведены ниже. Дополнительные справочные сведения см. на сайте https://jsonpath.com/.

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

`--debug`

Повышение уровня детализации журнала для включения всех журналов отладки.

`--help -h`

Отображение этого справочного сообщения и выход.

`--output -o`

Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json.

`--query -q`

Строка запроса JMESPath. Дополнительные сведения и примеры см. на сайте http://jmespath.org/.

`--verbose`

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

azdata bdc config patch

Вносит исправление в файл конфигурации в соответствии с указанным файлом исправления. Дополнительные сведения о том, как следует составлять пути, см. на сайте http://jsonpatch.com/. При выполнении операции замены в пути могут использоваться условные выражения посредством библиотеки jsonpath https://jsonpath.com/. Все файлы исправлений JSON должны начинаться с ключа "patch", который указывает на массив исправлений с соответствующими операциями (добавление, замена, удаление), путями и значениями. Для операции удаления не требуется значение, только путь. См. примеры ниже.

azdata bdc config patch --path 
                        --patch-file -p

Примеры

Пример 1. Замена порта одной конечной точки (конечной точки контроллера) с помощью файла исправления

azdata bdc config patch --path custom/control.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":"$.spec.endpoints[?(@.name=="Controller")].port","value":30080}]}

Пример 2. Замена хранилища уровня управления с помощью файла исправления

azdata bdc config patch --path custom/control.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":".spec.storage","value":{"accessMode":"ReadWriteMany","className":"managed-premium","size":"10Gi"}}]}

Пример 3. Замена пула носителей, включая реплики (пул носителей), с помощью файла исправления

azdata bdc config patch --path custom/bdc.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":"$.spec.resources.storage-0.spec","value":{"replicas": 2,"storage": {"className": "managed-premium","size": "10Gi","accessMode": "ReadWriteOnce"},"type": "Storage"}}]}

Необходимые параметры

`--path`

Путь к файлу с конфигурацией кластера больших данных, которую нужно задать, например custom/bdc.json

`--patch-file -p`

Путь к файлу исправления JSON на основе библиотеки jsonpatch: http://jsonpatch.com/. Файл исправления JSON должен начинаться с ключа "patch", значением которого является массив операций исправления, подлежащих выполнению. Для пути операции исправления можно использовать точечную нотацию, например ключ1.ключ2 для большинства операций. Если необходимо выполнить операцию замены и для замены значения в массиве требуется условное выражение, используйте нотацию jsonpath, указав в начале пути символ $. Это позволяет использовать условия, например, следующего вида: $.key1.key2[?(@.key3=='некотроеЗначение'].key4. См. примеры ниже. Дополнительные справочные сведения об условных выражениях см. на сайте https://jsonpath.com/.

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

`--debug`

Повышение уровня детализации журнала для включения всех журналов отладки.

`--help -h`

Отображение этого справочного сообщения и выход.

`--output -o`

Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json.

`--query -q`

Строка запроса JMESPath. Дополнительные сведения и примеры см. на сайте http://jmespath.org/.

`--verbose`

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Дальнейшие действия

Дополнительные сведения о других командах azdata см. в справочнике по azdata.

Дополнительные сведения об установке средства azdata см. в разделе Установка azdata.

Поделиться через

azdata bdc config

Команды

azdata bdc config init

Примеры

Необязательные параметры

--path -p

--source -s

--force -f

--accept-eula -a

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

--debug

--help -h

--output -o

--query -q

--verbose

azdata bdc config list

Примеры

Необязательные параметры

--config-profile -c

--type -t

--accept-eula -a

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

--debug

--help -h

--output -o

--query -q

--verbose

azdata bdc config show

Примеры

Необязательные параметры

--config-file -c

--target -t

--json-path -j

--force -f

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

--debug

--help -h

--output -o

--query -q

--verbose

azdata bdc config add

Примеры

Необходимые параметры

--path -p

--json-values -j

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

--debug

--help -h

--output -o

--query -q

--verbose

azdata bdc config remove

Примеры

Необходимые параметры

--path -p

--json-path -j

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

--debug

--help -h

--output -o

--query -q

--verbose

azdata bdc config replace

Примеры

Необходимые параметры

--path -p

--json-values -j

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

--debug

--help -h

--output -o

--query -q

--verbose

azdata bdc config patch

Примеры

Необходимые параметры

--path

--patch-file -p

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

`--path -p`

`--source -s`

`--force -f`

`--accept-eula -a`

`--debug`

`--help -h`

`--output -o`

`--query -q`

`--verbose`

`--config-profile -c`

`--type -t`

`--accept-eula -a`

`--debug`

`--help -h`

`--output -o`

`--query -q`

`--verbose`

`--config-file -c`

`--target -t`

`--json-path -j`

`--force -f`

`--debug`

`--help -h`

`--output -o`

`--query -q`

`--verbose`

`--path -p`

`--json-values -j`

`--debug`

`--help -h`

`--output -o`

`--query -q`

`--verbose`

`--path -p`

`--json-path -j`

`--debug`

`--help -h`

`--output -o`

`--query -q`

`--verbose`

`--path -p`

`--json-values -j`

`--debug`

`--help -h`

`--output -o`

`--query -q`

`--verbose`

`--path`

`--patch-file -p`

`--debug`

`--help -h`

`--output -o`

`--query -q`

`--verbose`