azdata bdc config

Область применения: Azure Data CLI ()azdata

Для новых сценариев автоматизации и управления предпочитайте azure CLI (az), расширения Azure CLI и портал Azure Arc.

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

Команды

azdata bdc config init

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

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

Примеры

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

azdata bdc config init

BDC config init with arguments, создает профиль конфигурации 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

Вы принимаете условия лицензионного соглашения? [да/нет]. Если вы не хотите использовать этот arg, можно задать для переменной среды ACCEPT_EULA значение "да". Условия лицензии для этого продукта можно просмотреть по 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

Вы принимаете условия лицензионного соглашения? [да/нет]. Если вы не хотите использовать этот arg, можно задать для переменной среды ACCEPT_EULA значение "да". Условия лицензии для этого продукта можно просмотреть по 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 show

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

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

Примеры

Отображение конфигурации BDC в консоли

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

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

--target -t

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

--json-path -j

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

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

Примеры

Ex 1— добавление хранилища плоскости управления.

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

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

--path -p

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

--json-values -j

Список пар значений ключа для путей json к значениям: key1.subkey1=value1,key2.subkey2=value2. Можно указать встроенные значения JSON, такие как: key='{"kind":"cluster","name":"test-cluster"}" или указать путь к файлу, например key=./values.json. Добавление не поддерживает условные условия. Если встроенное значение, которое вы предоставляете, — это пара "значение ключа" с "=" и "," и ", экранируйте эти символы. Например, key1="key2=val2,key3=val3". См. http://jsonpatch.com/ примеры того, как должен выглядеть путь. Если вы хотите получить доступ к массиву, необходимо сделать это, указав индекс, например key.0=value

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

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

Примеры

Ex 1— удаление хранилища плоскости управления.

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

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

--path -p

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

--json-path -j

Список путей JSON на основе библиотеки jsonpatch, указывающей, какие значения нужно удалить, например: key1.subkey1,key2.subkey2. Удаление не поддерживает условные условия. См. http://jsonpatch.com/ примеры того, как должен выглядеть путь. Если вы хотите получить доступ к массиву, необходимо сделать это, указав индекс, например key.0=value

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

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

Примеры

Ex 1 — замените порт одной конечной точки (конечная точка контроллера).

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

Ex 2 — замена хранилища плоскости управления.

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

Ex 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

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

--json-values -j

Список пар значений ключа для путей json к значениям: key1.subkey1=value1,key2.subkey2=value2. Можно указать встроенные значения JSON, такие как: key='{"kind":"cluster","name":"test-cluster"}" или указать путь к файлу, например key=./values.json. Замена поддерживает условные условия через библиотеку jsonpath. Для этого путь должен начинаться с символа $. Это позволит выполнить условное действие, например -j $.key1.key2[?( @.key3='someValue'].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", который содержит массив исправлений с соответствующими оповещениями (добавление, замена, удаление), путь и значение. Для операции remove не требуется значение, а только путь. См. приведенные ниже примеры.

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

Примеры

Ex 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}]}

Ex 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"}}]}

Ex 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

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

--patch-file -p

Путь к файлу исправления JSON на основе библиотеки jsonpatch: http://jsonpatch.com/. Необходимо запустить json-файл patch с ключом с именем patch, значение которого является массивом операций исправления, которые вы планируете сделать. Для пути операции исправления можно использовать нотацию точек, например key1.key2 для большинства операций. Если необходимо выполнить операцию замены и для замены значения в массиве требуется условное выражение, используйте нотацию jsonpath, указав в начале пути символ $. Это позволит выполнить условное действие, например $.key1.key2[?( @.key3='someValue'].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.