다음을 통해 공유


azdata bdc config

적용 대상: Azure Data CLI(azdata)

메모

이전에 Azure Data CLI(azdata)에서 처리한 일부 시나리오는 이제 Azure CLI(az) 확장Azure Arc 기반 워크플로를 통해 관리됩니다. 모든 azdata 명령에 대한 단일 1:1 대체는 없습니다. 다음 표에서는 일반적으로 관련된 Azure CLI 대안이 존재하는 위치를 중점적으로 설명합니다.

azdata 명령 영역 Azure CLI 확장/명령 그룹 Azure CLI 참조
azdata arc dc * az arcdata Azure Arc 데이터 CLI 참조
azdata arc sql mi * az arcdata sql mi CLI를 사용하여 Azure SQL Managed Instance 관리
azdata arc postgres * az arcdata postgres CLI를 사용하여 PostgreSQL 서버 관리
azdata migrate * az datamigration CLI를 사용하여 마이그레이션
azdata extension * az extension * Azure CLI 확장 개요
azdata login az login az login
azdata sql shell / azdata sql query Azure CLI에 해당하지 않음(사용 sqlcmd, SSMS 또는 기타 SQL 도구) sqlcmd 유틸리티

SQL Server Management Studio

새 자동화 및 관리 시나리오의 경우 Azure CLI(az), Azure CLI 확장Azure Arc Portal 환경을 선호합니다.

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

명령어

Command 설명
azdata bdc config init bdc 만들기와 함께 사용할 수 있는 빅 데이터 클러스터 구성 프로필을 초기화합니다.
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 만들기와 함께 사용할 수 있는 빅 데이터 클러스터 구성 프로필을 초기화합니다. 구성 프로필의 특정 원본은 인수에 지정할 수 있습니다.

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

사용 조건에 동의합니까? [예/아니요]. 이 인수를 사용하지 않으려면 환경 변수 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

구성에서 원하는 섹션 또는 값(예: 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같은 파일 경로를 제공할 수 있습니다. 바꾸기는 jsonpath 라이브러리를 통해 조건부를 지원합니다. 이를 사용하려면 $로 경로를 시작합니다. 이렇게 하면 $.key1.key2[?( -j 같은 조건부 작업을 수행할 수 있습니다. @.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 파일은 해당 작업(추가, 바꾸기, 제거), 경로 및 값이 있는 패치 배열이 있는 "패치" 키로 시작해야 합니다. "remove" op에는 값이 필요하지 않고 경로만 필요합니다. 아래 예제를 참조하세요.

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 설치를 참조하세요.