az sql mi-arc

참고 항목

이 참조는 Azure CLI(버전 2.3.1 이상)에 대한 arcdata 확장의 일부입니다. az sql mi-arc 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

Azure Arc 지원 SQL 관리형 인스턴스를 관리합니다.

명령

Name	Description	형식	상태
az sql mi-arc config	구성 명령.	내선 번호	GA
az sql mi-arc config add	구성 파일에서 json 경로에 대한 값을 추가합니다.	내선 번호	GA
az sql mi-arc config init	SQL 관리형 인스턴스에 대한 CRD 및 사양 파일을 초기화합니다.	내선 번호	GA
az sql mi-arc config patch	json 패치 파일을 기반으로 구성 파일을 패치합니다.	내선 번호	GA
az sql mi-arc config remove	구성 파일에서 json 경로에 대한 값을 제거합니다.	내선 번호	GA
az sql mi-arc config replace	구성 파일에서 json 경로의 값을 바꿉합니다.	내선 번호	GA
az sql mi-arc create	SQL 관리되는 인스턴스를 만듭니다.	내선 번호	GA
az sql mi-arc delete	SQL 관리형 인스턴스를 삭제합니다.	내선 번호	GA
az sql mi-arc edit	더 이상 사용되지 않으며 편집을 통해 업데이트를 사용합니다.	내선 번호	더 이상 사용되지 않음
az sql mi-arc endpoint	SQL 엔드포인트를 보고 관리합니다.	내선 번호	GA
az sql mi-arc endpoint list	SQL 엔드포인트를 나열합니다.	내선 번호	GA
az sql mi-arc get-mirroring-cert	sql mi에서 가용성 그룹 미러링 엔드포인트의 인증서를 검색하고 파일에 저장합니다.	내선 번호	GA
az sql mi-arc list	SQL 관리되는 인스턴스를 나열합니다.	내선 번호	GA
az sql mi-arc reprovision-replica	SQL 관리되는 인스턴스에서 복제본(replica) 다시 프로비전합니다.	내선 번호	GA
az sql mi-arc show	SQL 관리형 인스턴스의 세부 정보를 표시합니다.	내선 번호	GA
az sql mi-arc update	SQL 관리형 인스턴스의 구성을 업데이트합니다.	내선 번호	GA
az sql mi-arc upgrade	SQL 관리되는 인스턴스를 업그레이드합니다.	내선 번호	GA

az sql mi-arc create

SQL 관리되는 인스턴스를 만듭니다.

SQL 관리되는 인스턴스의 암호를 설정하려면 환경 변수 AZDATA_PASSWORD 설정합니다.

az sql mi-arc create --name
                     [--ad-account-name]
                     [--ad-connector-name]
                     [--ad-encryption-types]
                     [--admin-login-secret]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--collation]
                     [--cores-limit]
                     [--cores-request]
                     [--custom-location]
                     [--dev]
                     [--k8s-namespace]
                     [--keytab-secret]
                     [--labels]
                     [--language]
                     [--license-type]
                     [--memory-limit]
                     [--memory-request]
                     [--no-external-endpoint]
                     [--no-wait]
                     [--orchestrator-replicas]
                     [--path]
                     [--primary-dns-name]
                     [--primary-port-number]
                     [--readable-secondaries]
                     [--replicas {1, 2, 3}]
                     [--resource-group]
                     [--retention-days]
                     [--secondary-dns-name]
                     [--secondary-port-number]
                     [--service-annotations]
                     [--service-cert-secret]
                     [--service-labels]
                     [--service-type {LoadBalancer, NodePort}]
                     [--storage-annotations]
                     [--storage-class-backups]
                     [--storage-class-data]
                     [--storage-class-datalogs]
                     [--storage-class-logs]
                     [--storage-class-orchestrator-logs]
                     [--storage-labels]
                     [--sync-secondary-to-commit {-1, 0, 1, 2}]
                     [--tde-mode]
                     [--tde-protector-private-key-file]
                     [--tde-protector-public-key-file]
                     [--tde-protector-secret]
                     [--tier]
                     [--time-zone]
                     [--trace-flags]
                     [--use-k8s]
                     [--volume-size-backups]
                     [--volume-size-data]
                     [--volume-size-datalogs]
                     [--volume-size-logs]
                     [--volume-size-orchestrator-logs]

예제

Kubernetes API를 통해 SQL 관리되는 인스턴스를 만듭니다.

az sql mi-arc create -n sqlmi1 --k8s-namespace arc --use-k8s

Kubernetes API를 통해 HA 시나리오에서 3개의 복제본(replica) 사용하여 SQL 관리형 인스턴스를 만듭니다.

az sql mi-arc create -n sqlmi2 --replicas 3 --k8s-namespace arc --use-k8s

ARM(Azure Resource Manager)을 통해 SQL 관리형 인스턴스를 만듭니다.

az sql mi-arc create --name sqlmi3 --resource-group rg-name --custom-location arc-cl

Kubernetes API를 통해 Active Directory 인증을 사용하여 SQL 관리되는 인스턴스를 만듭니다.

az sql mi-arc create --name contososqlmi --k8s-namespace arc --ad-connector-name arcadc --ad-account-name arcuser --keytab-secret arcuser-keytab-secret --primary-dns-name contososqlmi-primary.contoso.local --primary-port-number 8143 --use-k8s

필수 매개 변수

--name -n

SQL 관리형 인스턴스의 이름입니다.

선택적 매개 변수

--ad-account-name

이 Arc 지원 SQL Managed Instance의 Active Directory 계정 이름입니다. 이 인스턴스를 배포하기 전에 이 계정을 만들어야 합니다.

--ad-connector-name

Active Directory 커넥트or의 이름입니다. 이 매개 변수는 AD 지원을 사용하여 배포하려는 의도를 나타냅니다.

--ad-encryption-types

지원되는 Active Directory 암호화 유형의 쉼표로 구분된 목록입니다. RC4, AES128, AES256 값의 하위 집합이어야 합니다.

--admin-login-secret

해당 호스트를 생성하거나 사용자 관리자 로그인 계정 자격 증명을 호스트할 Kubernetes 비밀의 이름입니다.

--agent-enabled

인스턴스에 대해 SQL Server 에이전트를 사용하도록 설정합니다. 기본값은 사용 안 함입니다. 허용되는 값은 ‘true’ 또는 ‘false’입니다.

--annotations

SQL 관리형 인스턴스 주석의 쉼표로 구분된 목록입니다.

--cert-private-key-file

SQL Server에 사용할 PEM 형식 인증서 프라이빗 키가 포함된 파일의 경로입니다.

--cert-public-key-file

SQL Server에 사용할 PEM 형식 인증서 공개 키가 포함된 파일의 경로입니다.

--collation

인스턴스에 대한 SQL Server 데이터 정렬입니다.

--cores-limit -c

관리되는 인스턴스의 코어 제한은 정수로 제한됩니다.

--cores-request

정수로 관리되는 인스턴스의 코어에 대한 요청입니다.

--custom-location

이 인스턴스의 사용자 지정 위치입니다.

--dev

이 매개 변수를 지정하면 개발 인스턴스로 간주되어 요금이 청구되지 않습니다.

--k8s-namespace -k

SQL 관리형 인스턴스를 배포할 네임스페이스입니다. 네임스페이스를 지정하지 않으면 kubeconfig에 정의된 네임스페이스가 사용됩니다.

--keytab-secret

이 Arc 지원 SQL Managed Instance에 대한 keytab 파일을 포함하는 Kubernetes 비밀의 이름입니다.

--labels

쉼표로 구분된 SQL 관리형 인스턴스 레이블 목록입니다.

--language

인스턴스에 지원되는 언어 식별자(LCID)에 대한 SQL Server 로캘입니다.

--license-type -l

이 관리되는 인스턴스 허용 값에 적용할 라이선스 유형은 BasePrice, LicenseIncluded, DisasterRecovery.Default가 LicenseIncluded입니다. 라이선스 유형을 변경할 수 있습니다.

--memory-limit -m

관리되는 인스턴스의 용량 제한은 정수로, Gi(기가바이트)입니다. 예: 4Gi.

--memory-request

관리되는 인스턴스의 용량에 대한 요청은 정수로, Gi(기가바이트)입니다. 예: 4Gi.

--no-external-endpoint

지정한 경우 외부 서비스가 만들어지지 않습니다. 그렇지 않으면 데이터 컨트롤러와 동일한 서비스 유형을 사용하여 외부 서비스를 만듭니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

기본값: False

--orchestrator-replicas

고가용성 오케스트레이터 복제본(replica) 수입니다. 값은 1에서 3 사이여야 합니다.

--path

SQL 관리형 인스턴스 json 파일에 대한 azext_arcdata 파일의 경로입니다.

--primary-dns-name

이 Arc 지원 SQL Managed Instance(예: sqlinstancename.contoso.com)에 연결하기 위해 최종 사용자에게 노출되는 기본 서비스 DNS 이름입니다.

--primary-port-number

기본 서비스가 최종 사용자에게 노출되는 포트 번호입니다(예: 31433).

--readable-secondaries

읽을 수 있는 복제본(replica) 수입니다. 중요 비즈니스용 계층에만 적용됩니다. 값은 0에서 1을 뺀 복제본(replica) 수 사이여야 합니다.

--replicas

이 옵션은 고가용성을 위해 Kubernetes 클러스터에 배포될 SQL Managed Instance 복제본(replica) 수를 지정합니다. 기본값은 범용 복제본(replica) 1개, 중요 비즈니스용 복제본(replica) 3개입니다.

허용되는 값: 1, 2, 3

--resource-group -g

Arc 지원 SQL Managed Instance를 추가해야 하는 Azure 리소스 그룹입니다.

--retention-days

백업 보존 기간(일 단위로 지정됨) 허용되는 값은 0~35입니다. 기본값은 7입니다. 보존 기간을 0으로 설정하면 SQL 관리되는 인스턴스의 모든 데이터베이스에 대한 자동 백업이 꺼지고 모든 이전 백업이 삭제됩니다.

--secondary-dns-name

이 Arc 지원 SQL Managed Instance(예: sqlinstancename2.contoso.com)에 연결하기 위해 최종 사용자에게 노출되는 보조 서비스 DNS 이름입니다.

--secondary-port-number

보조 서비스가 최종 사용자에게 노출되는 포트 번호입니다(예: 31434).

--service-annotations

모든 외부 서비스에 적용할 주석의 쉼표로 구분된 목록입니다.

--service-cert-secret

SQL 서비스 인증서를 호스트하도록 생성할 Kubernetes 비밀의 이름입니다.

--service-labels

모든 외부 서비스에 적용할 레이블의 쉼표로 구분된 목록입니다.

--service-type

기본 서비스의 형식입니다.

허용되는 값: LoadBalancer, NodePort

--storage-annotations

모든 PVC에 적용할 주석의 쉼표로 구분된 목록입니다.

--storage-class-backups

백업(/var/opt/mssql/backups)에 사용할 RWX(ReadWriteMany) 지원 스토리지 클래스입니다. 값을 지정하지 않으면 기본 스토리지 클래스가 사용됩니다.

--storage-class-data -d

데이터 파일(.mdf, .ndf)에 사용할 스토리지 클래스입니다. 값을 지정하지 않으면 스토리지 클래스가 지정되지 않으므로 Kubernetes에서 기본 스토리지 클래스를 사용합니다.

--storage-class-datalogs

데이터베이스 로그(.ldf)에 사용할 스토리지 클래스입니다. 값을 지정하지 않으면 스토리지 클래스가 지정되지 않으므로 Kubernetes에서 기본 스토리지 클래스를 사용합니다.

--storage-class-logs

로그(/var/log)에 사용할 스토리지 클래스입니다. 값을 지정하지 않으면 스토리지 클래스가 지정되지 않으므로 Kubernetes에서 기본 스토리지 클래스를 사용합니다.

--storage-class-orchestrator-logs

오케스트레이터 로그(/var/log)에 사용할 스토리지 클래스입니다. 값을 지정하지 않으면 스토리지 클래스가 지정되지 않으므로 Kubernetes에서 기본 스토리지 클래스를 사용합니다.

--storage-labels

모든 PVC에 적용할 레이블의 쉼표로 구분된 목록입니다.

--sync-secondary-to-commit

커밋하기 위해 동기화해야 하는 보조 복제본(replica) 수입니다. 이 값을 -1로 설정하면 필요한 동기화된 보조 복제본 수가 '(#of 복제본(replica)s - 1) / 2'로 설정되고 반올림됩니다.

허용되는 값: -1, 0, 1, 2

기본값: -1

--tde-mode

이 Arc 지원 SQL Managed Instance에 대한 TDE(투명한 데이터 암호화) 모드입니다. 허용되는 값: ServiceManaged, CustomerManaged 또는 Disabled입니다. 기본값은 사용 안 함입니다.

--tde-protector-private-key-file

TDE에 사용할 PEM 형식 인증서 프라이빗 키가 포함된 파일의 경로입니다.

--tde-protector-public-key-file

TDE에 사용할 PEM 형식 인증서 공개 키가 포함된 파일의 경로입니다.

--tde-protector-secret

이 Arc 지원 SQL Managed Instance에 대한 TDE 보호기 인증서 및 프라이빗 키를 포함하는 Kubernetes 비밀의 이름입니다. CustomerManaged TDE 모드에만 지정할 수 있습니다.

--tier -t

인스턴스에 대한 가격 책정 계층입니다. 허용되는 값: BusinessCritical(bc for short) 또는 GeneralPurpose(gp for short). 기본값은 GeneralPurpose입니다.

--time-zone

인스턴스의 SQL Server 표준 시간대입니다.

--trace-flags

쉼표로 구분된 traceflags 목록입니다. 기본적으로 플래그가 없습니다.

--use-k8s

로컬 Kubernetes API를 사용하여 SQL 관리형 인스턴스를 만듭니다.

--volume-size-backups

백업에 사용할 스토리지 볼륨 크기로, 양수 뒤에 Ki(킬로바이트), Mi(메가바이트) 또는 Gi(기가바이트)가 옵니다.

--volume-size-data

데이터에 사용할 스토리지 볼륨의 크기는 양수로, Ki(킬로바이트), Mi(메가바이트) 또는 Gi(기가바이트)입니다.

--volume-size-datalogs

데이터 로그에 사용할 스토리지 볼륨 크기로, 양수 뒤에 Ki(킬로바이트), Mi(메가바이트) 또는 Gi(기가바이트)가 옵니다.

--volume-size-logs

로그에 대해 양수로 사용할 스토리지 볼륨의 크기이며 Ki(킬로바이트), Mi(메가바이트) 또는 Gi(기가바이트)가 뒤따릅니다.

--volume-size-orchestrator-logs

오케스트레이터 로그에 사용할 스토리지 볼륨의 크기는 양수로, Ki(킬로바이트), Mi(메가바이트) 또는 Gi(기가바이트)입니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql mi-arc delete

SQL 관리형 인스턴스를 삭제합니다.

az sql mi-arc delete --name
                     [--k8s-namespace]
                     [--no-wait]
                     [--resource-group]
                     [--use-k8s]

예제

Kubernetes API를 통해 SQL 관리되는 인스턴스를 삭제합니다.

az sql mi-arc delete --name sqlmi1 --k8s-namespace arc --use-k8s

ARM(Azure Resource Manager)을 통해 SQL 관리형 인스턴스를 삭제합니다.

az sql mi-arc delete --name sqlmi1 --resource-group rg-name

필수 매개 변수

--name -n

삭제할 SQL 관리되는 인스턴스의 이름입니다.

선택적 매개 변수

--k8s-namespace -k

SQL 관리형 인스턴스를 배포할 네임스페이스입니다. 네임스페이스를 지정하지 않으면 kubeconfig에 정의된 네임스페이스가 사용됩니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

기본값: False

--resource-group -g

Arc 지원 SQL Managed Instance가 있는 Azure 리소스 그룹입니다.

--use-k8s

로컬 Kubernetes API를 사용하여 이 작업을 수행합니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql mi-arc edit

사용되지 않음

이 명령은 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 'update'를 사용합니다.

더 이상 사용되지 않으며 편집을 통해 업데이트를 사용합니다.

az sql mi-arc edit --name
                   [--agent-enabled]
                   [--annotations]
                   [--cores-limit]
                   [--cores-request]
                   [--custom-location]
                   [--dev]
                   [--k8s-namespace]
                   [--labels]
                   [--license-type]
                   [--location]
                   [--memory-limit]
                   [--memory-request]
                   [--no-wait]
                   [--path]
                   [--resource-group]
                   [--retention-days]
                   [--service-annotations]
                   [--service-labels]
                   [--tag-name]
                   [--tag-value]
                   [--tier]
                   [--time-zone]
                   [--trace-flags]
                   [--use-k8s]

필수 매개 변수

--name -n

편집 중인 SQL 관리형 인스턴스의 이름입니다. 인스턴스를 배포하는 데 사용되는 이름은 변경할 수 없습니다.

선택적 매개 변수

--agent-enabled

인스턴스에 대해 SQL Server 에이전트를 사용하도록 설정합니다. 기본값은 사용 안 함입니다.

--annotations

SQL 관리형 인스턴스 주석의 쉼표로 구분된 목록입니다.

--cores-limit -c

관리되는 인스턴스의 코어 제한은 정수로 제한됩니다.

--cores-request

정수로 관리되는 인스턴스의 코어에 대한 요청입니다.

--custom-location

이 인스턴스의 사용자 지정 위치입니다.

--dev

이 매개 변수를 지정하면 개발 인스턴스로 간주되어 요금이 청구되지 않습니다.

--k8s-namespace -k

SQL 관리형 인스턴스를 배포할 네임스페이스입니다. 네임스페이스를 지정하지 않으면 kubeconfig에 정의된 네임스페이스가 사용됩니다.

--labels

쉼표로 구분된 SQL 관리형 인스턴스 레이블 목록입니다.

--license-type

이 관리되는 인스턴스 허용 값에 대해 업데이트할 라이선스 유형은 BasePrice, LicenseIncluded, DisasterRecovery입니다. 기본값은 LicenseIncluded입니다.

--location

sqlmi 메타데이터를 저장할 Azure 위치(예: eastus)입니다.

--memory-limit -m

관리되는 인스턴스의 용량 제한은 정수로, Gi(기가바이트)입니다. 예: 4Gi.

--memory-request

관리되는 인스턴스의 용량에 대한 요청은 정수로, Gi(기가바이트)입니다. 예: 4Gi.

--no-wait

지정된 경우에는 인스턴스가 준비 상태로 전환될 때까지 기다리지 않고 명령이 반환됩니다.

기본값: False

--path

SQL 관리형 인스턴스 json 파일에 대한 azext_arcdata 파일의 경로입니다.

--resource-group -g

Arc 지원 SQL Managed Instance가 있는 Azure 리소스 그룹입니다.

--retention-days

백업 보존 기간(일 단위로 지정됨) 허용되는 값은 0~35입니다. 기본값은 7입니다. 보존 기간을 0으로 설정하면 SQL 관리되는 인스턴스의 모든 데이터베이스에 대한 자동 백업이 꺼지고 모든 이전 백업이 삭제됩니다.

--service-annotations

모든 외부 서비스에 적용할 주석의 쉼표로 구분된 목록입니다.

--service-labels

모든 외부 서비스에 적용할 레이블의 쉼표로 구분된 목록입니다.

--tag-name

SQL 관리되는 인스턴스의 태그 이름입니다.

--tag-value

SQL 관리되는 인스턴스의 태그 값입니다.

--tier -t

인스턴스에 대한 가격 책정 계층입니다. 허용되는 값: BusinessCritical(bc for short) 또는 GeneralPurpose(gp for short). 기본값은 GeneralPurpose입니다.

--time-zone

인스턴스의 SQL Server 표준 시간대입니다.

--trace-flags

쉼표로 구분된 traceflags 목록입니다. 기본적으로 플래그가 없습니다.

--use-k8s

로컬 Kubernetes API를 사용하여 이 작업을 수행합니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql mi-arc get-mirroring-cert

sql mi에서 가용성 그룹 미러링 엔드포인트의 인증서를 검색하고 파일에 저장합니다.

az sql mi-arc get-mirroring-cert --cert-file
                                 --name
                                 [--k8s-namespace]
                                 [--use-k8s]

예제

sqlmi1에서 엔드포인트를 미러 가용성 그룹의 인증서를 검색하고 fileName1에 저장

az sql mi-arc get-mirroring-cert -n sqlmi1 --cert-file fileName1

필수 매개 변수

--cert-file

검색된 인증서를 PEM 형식으로 저장할 로컬 파일 이름입니다.

--name -n

SQL 관리형 인스턴스의 이름입니다.

선택적 매개 변수

--k8s-namespace -k

SQL 관리형 인스턴스를 배포할 네임스페이스입니다. 네임스페이스를 지정하지 않으면 kubeconfig에 정의된 네임스페이스가 사용됩니다.

--use-k8s

로컬 Kubernetes API를 사용하여 이 작업을 수행합니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql mi-arc list

SQL 관리되는 인스턴스를 나열합니다.

az sql mi-arc list [--custom-location]
                   [--k8s-namespace]
                   [--resource-group]
                   [--use-k8s]

예제

SQL 관리되는 인스턴스를 나열합니다.

az sql mi-arc list --use-k8s

선택적 매개 변수

--custom-location

Arc 지원 SQL Managed Instance가 배포되는 사용자 지정 위치입니다. 지정하지 않으면 리소스 그룹의 모든 인스턴스가 나열됩니다.

--k8s-namespace -k

Arc 지원 SQL Managed Instances를 포함하는 Kubernetes 네임스페이스입니다. 네임스페이스를 지정하지 않으면 kubeconfig에 정의된 네임스페이스가 사용됩니다.

--resource-group -g

Arc 지원 SQL Managed Instances를 포함하는 Azure 리소스 그룹입니다.

--use-k8s

로컬 Kubernetes API를 사용하여 이 작업을 수행합니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql mi-arc reprovision-replica

SQL 관리되는 인스턴스에서 복제본(replica) 다시 프로비전합니다.

az sql mi-arc reprovision-replica --name
                                  [--k8s-namespace]
                                  [--no-wait]
                                  [--use-k8s]

예제

예 1 - SQL 관리형 인스턴스 sqlmi1의 복제본(replica) 1을 다시 프로비전합니다.

az sql mi-arc reprovision-replica -n sqlmi1-1 --use-k8s --k8s-namespace namespace

필수 매개 변수

--name -n

SQL 관리되는 인스턴스의 이름은 다시 프로비전할 복제본(replica).

선택적 매개 변수

--k8s-namespace -k

SQL 관리형 인스턴스 복제본(replica) 배포되는 네임스페이스입니다. 네임스페이스를 지정하지 않으면 kubeconfig에 정의된 네임스페이스가 사용됩니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

기본값: False

--use-k8s

로컬 Kubernetes API를 사용하여 SQL 관리형 인스턴스 복제본(replica) 다시 프로비전합니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql mi-arc show

SQL 관리형 인스턴스의 세부 정보를 표시합니다.

az sql mi-arc show --name
                   [--k8s-namespace]
                   [--path]
                   [--resource-group]
                   [--use-k8s]

예제

Kubernetes API를 사용하여 SQL Managed Instance의 세부 정보를 표시합니다.

az sql mi-arc show --name sqlmi1 --k8s-namespace arc --use-k8s

ARM(Azure Resource Manager)을 쿼리하여 SQL Managed Instance의 세부 정보를 표시합니다.

az sql mi-arc show --name sqlmi1 --resource-group rg-name

필수 매개 변수

--name -n

표시할 SQL 관리되는 인스턴스의 이름입니다.

선택적 매개 변수

--k8s-namespace -k

SQL 관리형 인스턴스를 배포할 네임스페이스입니다. 네임스페이스를 지정하지 않으면 kubeconfig에 정의된 네임스페이스가 사용됩니다.

--path -p

SQL 관리형 인스턴스의 전체 사양을 기록할 경로입니다. 생략하면 사양이 표준 출력에 기록됩니다.

--resource-group -g

Arc 지원 SQL Managed Instance가 있는 Azure 리소스 그룹입니다.

--use-k8s

로컬 Kubernetes API를 사용하여 이 작업을 수행합니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql mi-arc update

SQL 관리형 인스턴스의 구성을 업데이트합니다.

az sql mi-arc update --name
                     [--ad-encryption-types]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--cores-limit]
                     [--cores-request]
                     [--k8s-namespace]
                     [--keytab-secret]
                     [--labels]
                     [--license-type]
                     [--memory-limit]
                     [--memory-request]
                     [--no-wait]
                     [--orchestrator-replicas]
                     [--path]
                     [--preferred-primary-replica]
                     [--readable-secondaries]
                     [--replicas {1, 2, 3}]
                     [--resource-group]
                     [--retention-days]
                     [--service-annotations]
                     [--service-cert-secret]
                     [--service-labels]
                     [--sync-secondary-to-commit {-1, 0, 1, 2}]
                     [--tde-mode]
                     [--tde-protector-private-key-file]
                     [--tde-protector-public-key-file]
                     [--tde-protector-secret]
                     [--tier]
                     [--time-zone]
                     [--trace-flags]
                     [--use-k8s]

예제

SQL 관리형 인스턴스의 구성을 업데이트합니다.

az sql mi-arc update --path ./spec.json -n sqlmi1 --use-k8s

필수 매개 변수

--name -n

편집 중인 SQL 관리형 인스턴스의 이름입니다. 인스턴스를 배포하는 데 사용되는 이름은 변경할 수 없습니다.

선택적 매개 변수

--ad-encryption-types

지원되는 Active Directory 암호화 유형의 쉼표로 구분된 목록입니다. RC4, AES128, AES256 값의 하위 집합이어야 합니다.

--agent-enabled

인스턴스에 대해 SQL Server 에이전트를 사용하도록 설정합니다. 기본값은 사용 안 함입니다.

--annotations

SQL 관리형 인스턴스 주석의 쉼표로 구분된 목록입니다.

--cert-private-key-file

SQL Server에 사용할 PEM 형식 인증서 프라이빗 키가 포함된 파일의 경로입니다.

--cert-public-key-file

SQL Server에 사용할 PEM 형식 인증서 공개 키가 포함된 파일의 경로입니다.

--cores-limit -c

관리되는 인스턴스의 코어 제한은 정수로 제한됩니다.

--cores-request

정수로 관리되는 인스턴스의 코어에 대한 요청입니다.

--k8s-namespace -k

SQL 관리형 인스턴스를 배포할 네임스페이스입니다. 네임스페이스를 지정하지 않으면 kubeconfig에 정의된 네임스페이스가 사용됩니다.

--keytab-secret

이 Arc 지원 SQL Managed Instance에 대한 keytab 파일을 포함하는 Kubernetes 비밀의 이름입니다.

--labels

쉼표로 구분된 SQL 관리형 인스턴스 레이블 목록입니다.

--license-type -l

이 관리되는 인스턴스 허용 값에 적용할 라이선스 유형은 BasePrice, LicenseIncluded, DisasterRecovery.Default가 LicenseIncluded입니다. 라이선스 유형을 변경할 수 있습니다.

--memory-limit -m

관리되는 인스턴스의 용량 제한은 정수로, Gi(기가바이트)입니다. 예: 4Gi.

--memory-request

관리되는 인스턴스의 용량에 대한 요청은 정수로, Gi(기가바이트)입니다. 예: 4Gi.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

기본값: False

--orchestrator-replicas

고가용성 오케스트레이터 복제본(replica) 수입니다. 값은 1에서 3 사이여야 합니다.

--path

SQL 관리형 인스턴스 json 파일에 대한 azext_arcdata 파일의 경로입니다.

--preferred-primary-replica

업데이트할 기본 기본 복제본(replica).

--readable-secondaries

읽을 수 있는 복제본(replica) 수입니다. 중요 비즈니스용 계층에만 적용됩니다. 값은 0에서 1을 뺀 복제본(replica) 수 사이여야 합니다.

--replicas

이 옵션은 고가용성을 위해 Kubernetes 클러스터에 배포될 SQL Managed Instance 복제본(replica) 수를 지정합니다.

허용되는 값: 1, 2, 3

--resource-group -g

Arc 지원 SQL Managed Instance가 있는 Azure 리소스 그룹입니다.

--retention-days

백업 보존 기간(일 단위로 지정됨) 허용되는 값은 0~35입니다. 기본값은 7입니다. 보존 기간을 0으로 설정하면 SQL 관리되는 인스턴스의 모든 데이터베이스에 대한 자동 백업이 꺼지고 모든 이전 백업이 삭제됩니다.

--service-annotations

모든 외부 서비스에 적용할 주석의 쉼표로 구분된 목록입니다.

--service-cert-secret

SQL 서비스 인증서를 호스트하도록 생성할 Kubernetes 비밀의 이름입니다.

--service-labels

모든 외부 서비스에 적용할 레이블의 쉼표로 구분된 목록입니다.

--sync-secondary-to-commit

커밋하기 위해 동기화해야 하는 보조 복제본(replica) 수입니다. 이 값을 -1로 설정하면 필요한 동기화된 보조 복제본 수가 '(#of 복제본(replica)s - 1) / 2'로 설정되고 반올림됩니다.

허용되는 값: -1, 0, 1, 2

--tde-mode

이 Arc 지원 SQL Managed Instance에 대한 TDE(투명한 데이터 암호화) 모드입니다. 허용되는 값: ServiceManaged, CustomerManaged 또는 Disabled입니다. 기본값은 사용 안 함입니다.

--tde-protector-private-key-file

TDE에 사용할 PEM 형식 인증서 프라이빗 키가 포함된 파일의 경로입니다.

--tde-protector-public-key-file

TDE에 사용할 PEM 형식 인증서 공개 키가 포함된 파일의 경로입니다.

--tde-protector-secret

이 Arc 지원 SQL Managed Instance에 대한 TDE 보호기 인증서 및 프라이빗 키를 포함하는 Kubernetes 비밀의 이름입니다. CustomerManaged TDE 모드에만 지정할 수 있습니다.

--tier -t

인스턴스에 대한 가격 책정 계층입니다. 허용되는 값: BusinessCritical(bc for short) 또는 GeneralPurpose(gp for short). 기본값은 GeneralPurpose입니다.

--time-zone

인스턴스의 SQL Server 표준 시간대입니다.

--trace-flags

쉼표로 구분된 traceflags 목록입니다. 기본적으로 플래그가 없습니다.

--use-k8s

로컬 Kubernetes API를 사용하여 이 작업을 수행합니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql mi-arc upgrade

SQL 관리되는 인스턴스를 업그레이드합니다.

SQL 관리형 인스턴스를 지정된 원하는 버전으로 업그레이드합니다. desired-version을 지정하지 않으면 데이터 컨트롤러 버전이 사용됩니다.

az sql mi-arc upgrade [--desired-version]
                      [--dry-run]
                      [--field-filter]
                      [--force]
                      [--k8s-namespace]
                      [--label-filter]
                      [--name]
                      [--no-wait]
                      [--resource-group]
                      [--target]
                      [--use-k8s]

예제

SQL 관리되는 인스턴스를 업그레이드합니다.

az sql mi-arc upgrade -n sqlmi1 -k arc --desired-version v1.1.0 --use-k8s

선택적 매개 변수

--desired-version -v

업그레이드할 최신 유효한 버전입니다. 선택 사항으로, 버전이 지정되지 않은 경우 데이터 컨트롤러 버전이 사용됩니다. 'auto'를 지정하여 유효한 최신 버전으로 자동으로 업그레이드합니다. 자동 업그레이드에 대한 자세한 내용은 다음 https://aka.ms/arc-sqlmi-auto-upgrade을 참조하세요.

--dry-run -d

업그레이드할 인스턴스를 나타내지만 실제로 인스턴스를 업그레이드하지는 않습니다.

--field-filter -f

리소스 속성에 따라 업그레이드할 인스턴스를 선택하도록 필터링합니다.

--force

인스턴스에 적용할 수 있는 모든 정책을 재정의하고 업그레이드를 시도합니다.

기본값: False

--k8s-namespace -k

SQL 관리형 인스턴스를 배포할 네임스페이스입니다. 네임스페이스를 지정하지 않으면 kubeconfig에 정의된 네임스페이스가 사용됩니다.

--label-filter -l

레이블에 따라 업그레이드할 인스턴스를 선택하도록 필터링합니다.

--name -n

SQL 관리형 인스턴스의 이름입니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

기본값: False

--resource-group -g

대상 Arc 지원 SQL Managed Instance가 있는 Azure 리소스 그룹입니다.

--target

사용되지 않음

옵션 '--target'은 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 '--desired-version'을 사용합니다.

업그레이드할 최신 유효한 버전입니다. 선택 사항으로, 버전이 지정되지 않은 경우 데이터 컨트롤러 버전이 사용됩니다. 'auto'를 지정하여 유효한 최신 버전으로 자동으로 업그레이드합니다. 자동 업그레이드에 대한 자세한 내용은 다음 https://aka.ms/arc-sqlmi-auto-upgrade을 참조하세요.

--use-k8s

로컬 Kubernetes API를 사용하여 이 작업을 수행합니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.