azdata bdc config

아티클
05/30/2023

적용 대상: Azure Data CLI(azdata)

다음 문서에서는 azdata 도구의 sql 명령에 대한 참조를 제공합니다. 다른 azdata 명령에 대한 자세한 내용은 azdata 참조를 참조하세요.

명령

명령	설명
azdata bdc config init	bdc create와 함께 사용할 수 있는 빅 데이터 클러스터 구성 프로필을 초기화합니다.
azdata bdc config list	사용 가능한 구성 프로필 선택 항목을 나열합니다.
azdata bdc config show	BDC의 현재 구성 또는 지정한 로컬 파일(즉, 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]

예제

안내에 따른 BDC 구성 초기화 환경 - 필요한 값에 대한 프롬프트가 표시됩니다.

azdata bdc config init

인수를 사용하는 BDC 구성 초기화 - ./custom에서 aks-dev-test의 구성 프로필을 만듭니다.

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

BDC의 현재 구성 또는 지정한 로컬 파일(즉, custom/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`

현재 로그인한 클러스터의 구성을 원하지 않는 경우 빅 데이터 클러스터 구성 파일 경로입니다(즉, 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 경로의 키-값 쌍 목록입니다. 예: key1.subkey1=value1,key2.subkey2=value2. key=‘{“kind”:“cluster”,“name”:“test-cluster”}’와 같은 인라인 json 값을 제공하거나 key=./values.json과 같은 파일 경로를 제공할 수 있습니다. add는 조건부를 지원하지 않습니다. 제공하는 인라인 값이 '=' 및 ''가 포함된 사용된 키 값 쌍인 경우 이러한 문자는 사용하지 마세요. 예를 들어 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

예제

예 1 - 제어 평면 스토리지를 제거합니다.

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

필수 매개 변수

`--path -p`

설정하려는 구성의 빅 데이터 클러스터 구성 파일 경로입니다(즉, custom/bdc.json).

`--json-path -j`

jsonpatch 라이브러리를 기준으로, 제거하려는 값을 나타내는 json 경로 목록입니다(예: key1.subkey1,key2.subkey2). remove는 조건부를 지원하지 않습니다. 경로를 표시하는 방법의 예제는 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

예제

예 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 - 복제본을 포함하여 스토리지-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 경로의 키-값 쌍 목록입니다. 예: key1.subkey1=value1,key2.subkey2=value2. key=‘{“kind”:“cluster”,“name”:“test-cluster”}’와 같은 인라인 json 값을 제공하거나 key=./values.json과 같은 파일 경로를 제공할 수 있습니다. replace는 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/ 을 참조하세요. replace 작업은 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`

jsonpatch 라이브러리(http://jsonpatch.com/ )를 기반으로 하는 패치 json 파일의 경로입니다. 수행하려는 패치 작업의 배열이 값으로 포함된 “patch” 키로 패치 json 파일을 시작해야 합니다. 패치 작업 경로의 경우 대부분의 작업은 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 설치를 참조하세요.

다음을 통해 공유

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`