azdata bdc config

아티클
01/02/2025

적용 대상: Azure Data CLI(azdata)

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

명령

명령	설명
azdata bdc config init	bdc create와 함께 사용할 수 있는 빅 데이터 클러스터 구성 프로필을 초기화합니다.
azdata bdc config list	사용 가능한 구성 프로필 선택 항목을 나열합니다.
azdata bdc config show	BDC의 현재 구성 또는 지정한 로컬 파일의 구성(예: 사용자 지정/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 구성 init는 ./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 '예'로 설정할 수 있습니다. 이 제품의 사용 조건은 .에서 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의 현재 구성 또는 지정한 로컬 파일의 구성(예: 사용자 지정/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`

구성에서 원하는 섹션 또는 값(예: key1.key2.key3)으로 이어지는 json 키 경로입니다. 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`

설정하려는 구성의 빅 데이터 클러스터 구성 파일 경로(예: 사용자 지정/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`

설정하려는 구성의 빅 데이터 클러스터 구성 파일 경로(예: 사용자 지정/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`

설정하려는 구성의 빅 데이터 클러스터 구성 파일 경로(예: 사용자 지정/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/을 참조하세요. 바꾸기 작업은 jsonpath 라이브러리로 인해 경로에 조건부를 사용할 수 있습니다 https://jsonpath.com/. 모든 패치 json 파일은 해당 작업(추가, 바꾸기, 제거), 경로 및 값이 있는 패치 배열이 있는 "패치" 키로 시작해야 합니다. “제거” 작업에는 값이 필요하지 않으며 경로만 있으면 됩니다. 아래 예제를 참조하세요.

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`

설정하려는 구성의 빅 데이터 클러스터 구성 파일 경로(예: 사용자 지정/bdc.json

`--patch-file -p`

jsonpatch 라이브러리를 기반으로 하는 패치 json 파일의 경로: http://jsonpatch.com/. 수행하려는 패치 작업의 배열이 값으로 포함된 “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`