Compartilhar via

az sql mi-arc

Note

Essa referência faz parte da extensão arcdata para o CLI do Azure (versão 2.3.1 ou superior). A extensão instalará automaticamente a primeira vez que você executar um comando az sql mi-arc. Saiba mais sobre extensões.

Gerenciar instâncias gerenciadas de SQL habilitadas para Azure Arc.

Comandos

Nome Description Tipo Status
az sql mi-arc config

Comandos de configuração.

 Extension GA
az sql mi-arc config add

Adicione um valor para um caminho json em um arquivo de configuração.

 Extension GA
az sql mi-arc config init

Inicialize o CRD e os arquivos de especificação para uma instância gerenciada de SQL.

 Extension GA
az sql mi-arc config patch

Corrija um arquivo de configuração com base em um arquivo de patch json.

 Extension GA
az sql mi-arc config remove

Remova um valor para um caminho json em um arquivo de configuração.

 Extension GA
az sql mi-arc config replace

Substitua um valor por um caminho json em um arquivo de configuração.

 Extension GA
az sql mi-arc create

Crie uma instância gerenciada de SQL.

 Extension GA
az sql mi-arc delete

Exclua uma instância gerenciada de SQL.

 Extension GA
az sql mi-arc endpoint

Exibir e gerenciar pontos de extremidade do SQL.

 Extension GA
az sql mi-arc endpoint list

Listar os pontos de extremidade do SQL.

 Extension GA
az sql mi-arc get-mirroring-cert

Recupere o certificado do ponto de extremidade de espelhamento do grupo de disponibilidade do sql mi e armazene em um arquivo.

 Extension GA
az sql mi-arc list

Listar instâncias gerenciadas de SQL.

 Extension GA
az sql mi-arc reprovision-replica

Reprovisionar uma réplica em uma instância gerenciada de SQL.

 Extension GA
az sql mi-arc show

Mostrar os detalhes de uma instância gerenciada de SQL.

 Extension GA
az sql mi-arc update

Atualize a configuração de uma instância gerenciada de SQL.

 Extension GA
az sql mi-arc upgrade

Atualizar a instância gerenciada do SQL.

 Extension GA

az sql mi-arc create

Crie uma instância gerenciada de SQL.

Para definir a senha da instância gerenciada de SQL, defina a variável de ambiente AZDATA_PASSWORD.

az sql mi-arc create --name
                     [--acquire-policy-token]
                     [--ad-account-name]
                     [--ad-connector-name]
                     [--ad-encryption-types]
                     [--admin-login-secret]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--change-reference]
                     [--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]
                     [--private-key-file]
                     [--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]

Exemplos

Crie uma instância gerenciada de SQL por meio da API do Kubernetes.

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

Crie uma instância gerenciada de SQL com três réplicas no cenário de HA por meio da API do Kubernetes.

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

Crie uma instância gerenciada de SQL por meio do ARM (Azure Resource Manager).

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

Crie uma instância gerenciada de SQL com Active Directory autenticação por meio da API do Kubernetes.

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

Parâmetros Exigidos

--name -n

O nome da instância gerenciada de SQL.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--ad-account-name

O nome da conta Active Directory para este Instância Gerenciada de SQL habilitado para Arc. Essa conta precisa ser criada antes da implantação dessa instância.

--ad-connector-name

O nome do conector Active Directory. Esse parâmetro indica uma intenção de implantar com suporte do AD.

--ad-encryption-types

Uma lista separada por vírgulas de tipos de criptografia de Active Directory com suporte. Deve ser um subconjunto dos seguintes valores: RC4, AES128, AES256.

--admin-login-secret

Nome do segredo do Kubernetes para gerar esses hosts ou hospedará a credencial da conta de logon do administrador do usuário.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--agent-enabled

Habilite SQL Server agente para a instância. O padrão está desabilitado. Os valores permitidos são 'true' ou 'false'.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--annotations

Lista separada por vírgulas de anotações da instância gerenciada de SQL.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--cert-private-key-file

Caminho para o arquivo que contém uma chave privada de certificado formatado PEM a ser usada para SQL Server.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--cert-public-key-file

Caminho para o arquivo que contém uma chave pública de certificado formatado PEM a ser usada para SQL Server.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--collation

A ordenação SQL Server para a instância.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--cores-limit -c

O limite de núcleos da instância gerenciada como um inteiro.

--cores-request

A solicitação de núcleos da instância gerenciada como um inteiro.

--custom-location

O local personalizado para essa instância.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--dev

Se isso for especificado, ele será considerado uma instância de desenvolvimento e não será cobrado.

--k8s-namespace -k

Namespace em que a instância gerenciada de SQL deve ser implantada. Se nenhum namespace for especificado, será usado aquele definido no kubeconfig.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--keytab-secret

O nome do segredo do Kubernetes que contém o arquivo de keytab para este Instância Gerenciada de SQL habilitado para Arc.

--labels

Lista separada por vírgulas de rótulos da instância gerenciada de SQL.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--language

O SQL Server localidade para qualquer LCID (identificador de idioma) com suporte para a instância.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--license-type -l

O tipo de licença a ser aplicado a essa instância gerenciada Os valores permitidos são: BasePrice, LicenseIncluded, DisasterRecovery.Default é LicenseIncluded. O tipo de licença pode ser alterado..

--memory-limit -m

O limite da capacidade da instância gerenciada como um número inteiro seguido por Gi (gigabytes). Exemplo: 4Gi.

--memory-request

A solicitação para a capacidade da instância gerenciada como um número inteiro seguido por Gi (gigabytes). Exemplo: 4Gi.

--no-external-endpoint

Se especificado, nenhum serviço externo será criado. Caso contrário, um serviço externo será criado usando o mesmo tipo de serviço que o controlador de dados.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--orchestrator-replicas

O número de réplicas do orquestrador de alta disponibilidade. O valor deve estar entre 1 e 3.

--path

O caminho para o arquivo azext_arcdata para o arquivo json da instância gerenciada de SQL.

--primary-dns-name

O nome DNS do serviço primário exposto aos usuários finais para se conectar a esse Instância Gerenciada de SQL habilitado para Arc (por exemplo, sqlinstancename.contoso.com).

--primary-port-number

O número da porta no qual o serviço primário é exposto aos usuários finais (por exemplo, 31433).

--private-key-file

Arquivo de chave privada gerado pelo openSSL para usar como id de instância.

--readable-secondaries

Número de réplicas a serem legíveis. Aplica-se somente à camada Comercialmente Crítica. O valor deve estar entre 0 e o número de réplicas menos 1.

--replicas

Essa opção especifica o número de réplicas Instância Gerenciada de SQL que serão implantadas no cluster do Kubernetes para fins de alta disponibilidade. O padrão é 1 réplica para Uso Geral, 3 réplicas para Comercialmente Crítico.

Propriedade Valor
Valores aceitos: 1, 2, 3
--resource-group -g

O Azure grupo de recursos ao qual a Instância Gerenciada de SQL habilitada para Arc deve ser adicionada.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--retention-days

Período de retenção de backup, especificado em dias. Os valores permitidos são de 0 a 35. O padrão é 7. Definir o período de retenção como 0 desativará backups automáticos para todos os bancos de dados na instância gerenciada de SQL e quaisquer backups anteriores serão excluídos.

--secondary-dns-name

O nome DNS do serviço secundário exposto aos usuários finais para se conectar a esse Instância Gerenciada de SQL habilitado para Arc (por exemplo, sqlinstancename2.contoso.com).

--secondary-port-number

O número da porta no qual o serviço secundário é exposto aos usuários finais (por exemplo, 31434).

--service-annotations

Lista separada por vírgulas de anotações a serem aplicadas a todos os serviços externos.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--service-cert-secret

Nome do segredo do Kubernetes para gerar esses hosts ou hospedará o certificado do serviço SQL.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--service-labels

Lista separada por vírgulas de rótulos a serem aplicadas a todos os serviços externos.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--service-type

O tipo do serviço primário.

Propriedade Valor
Valores aceitos: LoadBalancer, NodePort
--storage-annotations

Lista separada por vírgulas de anotações a serem aplicadas a todos os PVCs.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--storage-class-backups

Uma classe de armazenamento compatível com ReadWriteMany (RWX) a ser usada para backups (/var/opt/mssql/backups). Se nenhum valor for especificado, a classe de armazenamento padrão será usada.

--storage-class-data -d

A classe de armazenamento a ser usada para arquivos de dados (.mdf, .ndf). Se nenhum valor for especificado, nenhuma classe de armazenamento será especificada, o que resultará no Kubernetes usando a classe de armazenamento padrão.

--storage-class-datalogs

A classe de armazenamento a ser usada para logs de banco de dados (.ldf). Se nenhum valor for especificado, nenhuma classe de armazenamento será especificada, o que resultará no Kubernetes usando a classe de armazenamento padrão.

--storage-class-logs

A classe de armazenamento a ser usada para logs (/var/log). Se nenhum valor for especificado, nenhuma classe de armazenamento será especificada, o que resultará no Kubernetes usando a classe de armazenamento padrão.

--storage-class-orchestrator-logs

A classe de armazenamento a ser usada para logs de orquestrador (/var/log). Se nenhum valor for especificado, nenhuma classe de armazenamento será especificada, o que resultará no Kubernetes usando a classe de armazenamento padrão.

--storage-labels

Lista separada por vírgulas de rótulos a serem aplicados a todos os PVCs.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--sync-secondary-to-commit

Número de réplicas secundárias que devem ser sincronizadas para confirmação. Definir esse valor como -1 definirá o número de secundários sincronizados necessários como '(# de réplicas - 1) /2', arredondado para baixo.

Propriedade Valor
Valor padrão: -1
Valores aceitos: -1, 0, 1, 2
--tde-mode

O modo Transparent Data Encryption (TDE) para este Instância Gerenciada de SQL habilitado para Arc. Valores permitidos: ServiceManaged, CustomerManaged ou Disabled. O padrão é Desabilitado.

--tde-protector-private-key-file

Caminho para o arquivo que contém uma chave privada de certificado formatado PEM a ser usada para TDE.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--tde-protector-public-key-file

Caminho para o arquivo que contém uma chave pública de certificado formatado PEM a ser usada para TDE.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--tde-protector-secret

O nome do segredo do Kubernetes que contém o certificado protetor de TDE e a chave privada para este Instância Gerenciada de SQL habilitado para Arc. Só pode ser especificado para o modo TDE CustomerManaged.

--tier -t

O tipo de preço da instância. Valores permitidos: BusinessCritical (bc para abreviar) ou GeneralPurpose (gp para abreviar). O padrão é GeneralPurpose.

--time-zone

O SQL Server fuso horário para a instância.

--trace-flags

Lista separada por vírgulas de traceflags. Nenhum sinalizador por padrão.

--use-k8s

Crie uma instância gerenciada de SQL usando APIs locais do Kubernetes.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--volume-size-backups

O tamanho do volume de armazenamento a ser usado para backups como um número positivo seguido por Ki (quilobytes), Mi (megabytes) ou Gi (gigabytes).

--volume-size-data

O tamanho do volume de armazenamento a ser usado para dados como um número positivo seguido por Ki (quilobytes), Mi (megabytes) ou Gi (gigabytes).

--volume-size-datalogs

O tamanho do volume de armazenamento a ser usado para logs de dados como um número positivo seguido por Ki (quilobytes), Mi (megabytes) ou Gi (gigabytes).

--volume-size-logs

O tamanho do volume de armazenamento a ser usado para logs como um número positivo seguido por Ki (quilobytes), Mi (megabytes) ou Gi (gigabytes).

--volume-size-orchestrator-logs

O tamanho do volume de armazenamento a ser usado para logs de orquestrador como um número positivo seguido por Ki (quilobytes), Mi (megabytes) ou Gi (gigabytes).

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az sql mi-arc delete

Exclua uma instância gerenciada de SQL.

az sql mi-arc delete --name
                     [--acquire-policy-token]
                     [--change-reference]
                     [--k8s-namespace]
                     [--no-wait]
                     [--resource-group]
                     [--use-k8s]

Exemplos

Exclua uma instância gerenciada de SQL por meio da API do Kubernetes.

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

Exclua uma instância gerenciada de SQL por meio do ARM (Azure Resource Manager).

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

Parâmetros Exigidos

--name -n

O nome da instância gerenciada de SQL a ser excluída.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--k8s-namespace -k

Namespace em que a instância gerenciada de SQL deve ser implantada. Se nenhum namespace for especificado, será usado aquele definido no kubeconfig.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--resource-group -g

O Azure grupo de recursos no qual o Instância Gerenciada de SQL habilitado para Arc existe.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az sql mi-arc get-mirroring-cert

Recupere o certificado do ponto de extremidade de espelhamento do grupo de disponibilidade do sql mi e armazene em um arquivo.

az sql mi-arc get-mirroring-cert --cert-file
                                 --name
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--k8s-namespace]
                                 [--use-k8s]

Exemplos

Recuperar o certificado do ponto de extremidade de espelhamento do grupo de disponibilidade do sqlmi1 e armazenar no arquivo fileName1

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

Parâmetros Exigidos

--cert-file

O nome do arquivo local para armazenar o certificado recuperado no formato PEM.

--name -n

O nome da instância gerenciada de SQL.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--k8s-namespace -k

Namespace em que a instância gerenciada de SQL deve ser implantada. Se nenhum namespace for especificado, será usado aquele definido no kubeconfig.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az sql mi-arc list

Listar instâncias gerenciadas de SQL.

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

Exemplos

Listar instâncias gerenciadas de SQL.

az sql mi-arc list --use-k8s

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--custom-location

O local personalizado no qual as Instâncias Gerenciadas de SQL habilitadas para Arc são implantadas. Se não for especificado, todas as instâncias do grupo de recursos serão listadas.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--k8s-namespace -k

O namespace do Kubernetes que contém as Instâncias Gerenciadas de SQL habilitadas para Arc. Se nenhum namespace for especificado, será usado aquele definido no kubeconfig.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--resource-group -g

O Azure grupo de recursos que contém as Instâncias Gerenciadas de SQL habilitadas para Arc.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az sql mi-arc reprovision-replica

Reprovisionar uma réplica em uma instância gerenciada de SQL.

az sql mi-arc reprovision-replica --name
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--k8s-namespace]
                                  [--no-wait]
                                  [--use-k8s]

Exemplos

Ex 1 – Reprovisionar a réplica 1 da instância gerenciada de SQL sqlmi1.

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

Parâmetros Exigidos

--name -n

O nome da réplica da instância gerenciada de SQL a ser reprovisionada.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--k8s-namespace -k

Namespace em que a réplica da instância gerenciada de SQL é implantada. Se nenhum namespace for especificado, será usado aquele definido no kubeconfig.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--use-k8s

Reprovisionar a réplica da instância gerenciada de SQL usando APIs locais do Kubernetes.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az sql mi-arc show

Mostrar os detalhes de uma instância gerenciada de SQL.

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

Exemplos

Mostre os detalhes de um Instância Gerenciada de SQL usando a API do Kubernetes.

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

Mostre os detalhes de um Instância Gerenciada de SQL consultando o ARM (Azure Resource Manager).

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

Parâmetros Exigidos

--name -n

O nome da instância gerenciada de SQL a ser mostrada.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--k8s-namespace -k

Namespace em que a instância gerenciada de SQL deve ser implantada. Se nenhum namespace for especificado, será usado aquele definido no kubeconfig.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--path -p

Um caminho em que a especificação completa da instância gerenciada de SQL deve ser gravada. Se omitida, a especificação será gravada na saída padrão.

--resource-group -g

O Azure grupo de recursos no qual o Instância Gerenciada de SQL habilitado para Arc existe.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az sql mi-arc update

Atualize a configuração de uma instância gerenciada de SQL.

az sql mi-arc update --name
                     [--acquire-policy-token]
                     [--ad-encryption-types]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--change-reference]
                     [--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]

Exemplos

Atualize a configuração de uma instância gerenciada de SQL.

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

Parâmetros Exigidos

--name -n

O nome da instância gerenciada de SQL que está sendo editada. O nome no qual sua instância é implantada não pode ser alterado.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--ad-encryption-types

Uma lista separada por vírgulas de tipos de criptografia de Active Directory com suporte. Deve ser um subconjunto dos seguintes valores: RC4, AES128, AES256.

--agent-enabled

Habilite SQL Server agente para a instância. O padrão está desabilitado.

--annotations

Lista separada por vírgulas de anotações da instância gerenciada de SQL.

--cert-private-key-file

Caminho para o arquivo que contém uma chave privada de certificado formatado PEM a ser usada para SQL Server.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--cert-public-key-file

Caminho para o arquivo que contém uma chave pública de certificado formatado PEM a ser usada para SQL Server.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--cores-limit -c

O limite de núcleos da instância gerenciada como um inteiro.

--cores-request

A solicitação de núcleos da instância gerenciada como um inteiro.

--k8s-namespace -k

Namespace em que a instância gerenciada de SQL deve ser implantada. Se nenhum namespace for especificado, será usado aquele definido no kubeconfig.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--keytab-secret

O nome do segredo do Kubernetes que contém o arquivo de keytab para este Instância Gerenciada de SQL habilitado para Arc.

--labels

Lista separada por vírgulas de rótulos da instância gerenciada de SQL.

--license-type -l

O tipo de licença a ser aplicado a essa instância gerenciada Os valores permitidos são: BasePrice, LicenseIncluded, DisasterRecovery.Default é LicenseIncluded. O tipo de licença pode ser alterado..

--memory-limit -m

O limite da capacidade da instância gerenciada como um número inteiro seguido por Gi (gigabytes). Exemplo: 4Gi.

--memory-request

A solicitação para a capacidade da instância gerenciada como um número inteiro seguido por Gi (gigabytes). Exemplo: 4Gi.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--orchestrator-replicas

O número de réplicas do orquestrador de alta disponibilidade. O valor deve estar entre 1 e 3.

--path

O caminho para o arquivo azext_arcdata para o arquivo json da instância gerenciada de SQL.

--preferred-primary-replica

A réplica primária preferencial a ser atualizada.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--readable-secondaries

Número de réplicas a serem legíveis. Aplica-se somente à camada Comercialmente Crítica. O valor deve estar entre 0 e o número de réplicas menos 1.

--replicas

Essa opção especifica o número de réplicas Instância Gerenciada de SQL que serão implantadas no cluster do Kubernetes para fins de alta disponibilidade.

Propriedade Valor
Valores aceitos: 1, 2, 3
--resource-group -g

O Azure grupo de recursos no qual o Instância Gerenciada de SQL habilitado para Arc existe.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--retention-days

Período de retenção de backup, especificado em dias. Os valores permitidos são de 0 a 35. O padrão é 7. Definir o período de retenção como 0 desativará backups automáticos para todos os bancos de dados na instância gerenciada de SQL e quaisquer backups anteriores serão excluídos.

--service-annotations

Lista separada por vírgulas de anotações a serem aplicadas a todos os serviços externos.

--service-cert-secret

Nome do segredo do Kubernetes para gerar esses hosts ou hospedará o certificado do serviço SQL.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--service-labels

Lista separada por vírgulas de rótulos a serem aplicadas a todos os serviços externos.

--sync-secondary-to-commit

Número de réplicas secundárias que devem ser sincronizadas para confirmação. Definir esse valor como -1 definirá o número de secundários sincronizados necessários como '(# de réplicas - 1) /2', arredondado para baixo.

Propriedade Valor
Valores aceitos: -1, 0, 1, 2
--tde-mode

O modo Transparent Data Encryption (TDE) para este Instância Gerenciada de SQL habilitado para Arc. Valores permitidos: ServiceManaged, CustomerManaged ou Disabled. O padrão é Desabilitado.

--tde-protector-private-key-file

Caminho para o arquivo que contém uma chave privada de certificado formatado PEM a ser usada para TDE.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--tde-protector-public-key-file

Caminho para o arquivo que contém uma chave pública de certificado formatado PEM a ser usada para TDE.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--tde-protector-secret

O nome do segredo do Kubernetes que contém o certificado protetor de TDE e a chave privada para este Instância Gerenciada de SQL habilitado para Arc. Só pode ser especificado para o modo TDE CustomerManaged.

--tier -t

O tipo de preço da instância. Valores permitidos: BusinessCritical (bc para abreviar) ou GeneralPurpose (gp para abreviar). O padrão é GeneralPurpose.

--time-zone

O SQL Server fuso horário para a instância.

--trace-flags

Lista separada por vírgulas de traceflags. Nenhum sinalizador por padrão.

--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az sql mi-arc upgrade

Atualizar a instância gerenciada do SQL.

Atualize a instância gerenciada do SQL para a versão desejada especificada. Se a versão desejada não for especificada, a versão do controlador de dados será usada.

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

Exemplos

Atualizar a instância gerenciada do SQL.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--desired-version -v

A versão válida mais recente para a qual atualizar. Opcional, se nenhuma versão for especificada, a versão do controlador de dados será usada. Especifique 'auto' para atualizar automaticamente para a versão válida mais recente. Saiba mais sobre atualizações automáticas em: https://aka.ms/arc-sqlmi-auto-upgrade.

--dry-run -d

Indica qual instância seria atualizada, mas não atualiza as instâncias.

--field-filter -f

Filtre para selecionar instâncias a serem atualizadas com base nas propriedades do recurso.

--force

Substitui todas as políticas que podem ser aplicadas à instância e tenta a atualização.

Propriedade Valor
Valor padrão: False
--k8s-namespace -k

Namespace em que a instância gerenciada de SQL deve ser implantada. Se nenhum namespace for especificado, será usado aquele definido no kubeconfig.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
--label-filter -l

Filtre para selecionar a instância a ser atualizada com base nos rótulos.

--name -n

O nome da instância gerenciada de SQL.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--resource-group -g

O Azure grupo de recursos no qual o Instância Gerenciada de SQL habilitado para Arc de destino existe.

Propriedade Valor
Grupo de parâmetros: Azure Resource Manager – targeted Arguments
--target
Preterido

A opção '--target' foi preterida e será removida em uma versão futura. Em vez disso, use '--desired-version'.

A versão válida mais recente para a qual atualizar. Opcional, se nenhuma versão for especificada, a versão do controlador de dados será usada. Especifique 'auto' para atualizar automaticamente para a versão válida mais recente. Saiba mais sobre atualizações automáticas em: https://aka.ms/arc-sqlmi-auto-upgrade.

--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

Propriedade Valor
Grupo de parâmetros: Kubernetes API – targeted Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False