Compartilhar via


az sql mi-arc

Observação

Essa referência faz parte da extensão arcdata para a CLI do Azure (versão 2.3.1 ou superior). A extensão será instalada automaticamente na 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.

Extensão GA
az sql mi-arc config add

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

Extensão GA
az sql mi-arc config init

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

Extensão GA
az sql mi-arc config patch

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

Extensão GA
az sql mi-arc config remove

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

Extensão GA
az sql mi-arc config replace

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

Extensão GA
az sql mi-arc create

Criar uma Instância Gerenciada de SQL.

Extensão GA
az sql mi-arc delete

Excluir uma instância gerenciada de SQL.

Extensão GA
az sql mi-arc edit

Preterido, use update over edit.

Extensão Preterido
az sql mi-arc endpoint

Ver e gerenciar pontos de extremidade de SQL.

Extensão GA
az sql mi-arc endpoint list

Lista os pontos de extremidade SQL.

Extensão GA
az sql mi-arc get-mirroring-cert

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

Extensão GA
az sql mi-arc list

Listar Instâncias Gerenciadas de SQL.

Extensão GA
az sql mi-arc reprovision-replica

Reprovisione uma réplica em uma instância gerenciada pelo SQL.

Extensão GA
az sql mi-arc show

Mostrar os detalhes de uma Instância Gerenciada de SQL.

Extensão GA
az sql mi-arc update

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

Extensão GA
az sql mi-arc upgrade

Atualize a instância gerenciada de SQL.

Extensão GA

az sql mi-arc create

Criar uma Instância Gerenciada de SQL.

Para definir a senha da instância gerenciada do SQL, defina a variável de ambiente 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]

Exemplos

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

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

Crie uma instância gerenciada SQL com 3 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 pelo SQL por meio do Azure Resource Manager (ARM).

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

Crie uma instância gerenciada SQL com autenticação do Active Directory 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

--ad-account-name

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

--ad-connector-name

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

--ad-encryption-types

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

--admin-login-secret

O nome do segredo do Kubernetes a ser gerado, que hospeda ou hospedará a credencial da conta de logon do administrador de usuários.

--agent-enabled

Habilite o agente do SQL Server para a instância. O padrão é desabilitado. Valores permitidos: 'true' ou 'false'.

--annotations

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

--cert-private-key-file

O caminho do arquivo que contém uma chave privada de certificado formatada em PEM a ser usada no SQL Server.

--cert-public-key-file

O caminho do arquivo que contém uma chave pública de certificado formatada em PEM a ser usada no SQL Server.

--collation

O agrupamento do SQL Server para a instância.

--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 esta instância.

--dev

Se isso for especificado, 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.

--keytab-secret

O nome do segredo do Kubernetes que contém o arquivo keytab para essa instância gerenciada SQL habilitada para Arc.

--labels

Lista separada por vírgulas de rótulos da Instância Gerenciada de SQL.

--language

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

--license-type -l

O tipo de licença a ser aplicado para esta instância gerenciada Os valores permitidos são: BasePrice, LicenseIncluded, DisasterRecovery.Default is 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 da 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.

--no-wait

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

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 do 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 conectarem a essa Instância Gerenciada SQL habilitada para Arc (por exemplo, sqlinstancename.contoso.com).

--primary-port-number

O número da porta na qual o serviço principal está exposto aos usuários finais (por exemplo, 31433).

--readable-secondaries

Número de réplicas a serem legíveis. Aplica-se somente ao nível Crítico de Negócios. 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 de Instância Gerenciada 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 Críticas aos Negócios.

valores aceitos: 1, 2, 3
--resource-group -g

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

--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á os backups automáticos para todos os bancos de dados na instância gerenciada SQL e todos os backups anteriores serão excluídos.

--secondary-dns-name

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

--secondary-port-number

O número da porta na qual o serviço secundário está exposto aos utilizadores finais (por exemplo, 31434).

--service-annotations

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

--service-cert-secret

O nome do segredo do Kubernetes a ser gerado, que hospeda ou hospedará o certificado de serviço SQL.

--service-labels

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

--service-type

O tipo para o serviço principal.

valores aceitos: LoadBalancer, NodePort
--storage-annotations

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

--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 uso da classe de armazenamento padrão pelo Kubernetes.

--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 uso da classe de armazenamento padrão pelo Kubernetes.

--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 uso da classe de armazenamento padrão pelo Kubernetes.

--storage-class-orchestrator-logs

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

--storage-labels

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

--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.

valores aceitos: -1, 0, 1, 2
valor padrão: -1
--tde-mode

O modo TDE (Transparent Data Encryption) para essa instância gerenciada SQL habilitada para Arc. Valores permitidos: ServiceManaged, CustomerManage ou Disabled. O padrão é Desabilitado.

--tde-protector-private-key-file

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

--tde-protector-public-key-file

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

--tde-protector-secret

O nome do segredo do Kubernetes que contém o certificado do protetor TDE e a chave privada para essa instância gerenciada SQL habilitada para Arc. Só pode ser especificado para o modo TDE CustomerManaged .

--tier -t

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

--time-zone

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

--trace-flags

Lista separada por vírgulas de sinalizadores de rastreamento. Sem sinalizadores por padrão.

--use-k8s

Crie a Instância Gerenciada de SQL usando APIs locais do Kubernetes.

--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 os 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 os 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 os 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 do orquestrador como um número positivo, seguido por Ki (quilobytes), Mi (megabytes) ou Gi (gigabytes).

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az sql mi-arc delete

Excluir uma instância gerenciada de SQL.

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

Exemplos

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

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

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

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

--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.

--no-wait

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

valor padrão: False
--resource-group -g

O grupo de recursos do Azure no qual a Instância Gerenciada SQL habilitada para Arc existe.

--use-k8s

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

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az sql mi-arc edit

Preterido

Esse comando foi preterido e será removido em uma versão futura. Em vez disso, use 'atualizar'.

Preterido, use update over edit.

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]

Parâmetros Exigidos

--name -n

O nome da Instância Gerenciada de SQL sendo editada. O nome sob o qual sua instância está implantada não pode ser alterado.

Parâmetros Opcionais

--agent-enabled

Habilite o agente do SQL Server para a instância. O padrão é desabilitado.

--annotations

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

--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 esta instância.

--dev

Se isso for especificado, 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.

--labels

Lista separada por vírgulas de rótulos da Instância Gerenciada de SQL.

--license-type

O tipo de licença a ser atualizado para esta instância gerenciada Os valores permitidos são: BasePrice, LicenseIncluded, DisasterRecovery. O padrão é LicenseIncluded.

--location

O local do Azure no qual os metadados sqlmi serão armazenados (por exemplo, eastus).

--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 da capacidade da Instância Gerenciada como um número inteiro seguido por Gi (gigabytes). Exemplo: 4Gi.

--no-wait

Se for fornecido, o comando não aguardará que a instância esteja em um estado pronto antes de retornar.

valor padrão: False
--path

O caminho do arquivo azext_arcdata para o arquivo JSON da Instância Gerenciada de SQL.

--resource-group -g

O grupo de recursos do Azure no qual a Instância Gerenciada SQL habilitada para Arc existe.

--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á os backups automáticos para todos os bancos de dados na instância gerenciada SQL e todos os 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-labels

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

--tag-name

O nome da marca da instância gerenciada do SQL.

--tag-value

O valor da tag da instância gerenciada do SQL.

--tier -t

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

--time-zone

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

--trace-flags

Lista separada por vírgulas de sinalizadores de rastreamento. Sem sinalizadores por padrão.

--use-k8s

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

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az sql mi-arc get-mirroring-cert

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

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

Exemplos

Recupere o certificado do ponto de extremidade de espelhamento do grupo de disponibilidade de sqlmi1 e armazene em um 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

--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.

--use-k8s

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

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

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

--custom-location

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

--k8s-namespace -k

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

--resource-group -g

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

--use-k8s

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

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az sql mi-arc reprovision-replica

Reprovisione uma réplica em uma instância gerenciada pelo SQL.

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

Exemplos

Ex 1 - Reprovisione a réplica 1 da instância gerenciada 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 SQL a ser reprovisionada.

Parâmetros Opcionais

--k8s-namespace -k

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

--no-wait

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

valor padrão: False
--use-k8s

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

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

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

Mostrar os detalhes de uma instância gerenciada do SQL usando a API do Kubernetes.

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

Mostre os detalhes de uma Instância Gerenciada SQL consultando o Gerenciador de Recursos do Azure (ARM).

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

--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.

--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 grupo de recursos do Azure no qual a Instância Gerenciada SQL habilitada para Arc existe.

--use-k8s

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

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az sql mi-arc update

Atualize a configuração de uma instância gerenciada de 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]

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 sendo editada. O nome sob o qual sua instância está implantada não pode ser alterado.

Parâmetros Opcionais

--ad-encryption-types

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

--agent-enabled

Habilite o agente do SQL Server para a instância. O padrão é desabilitado.

--annotations

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

--cert-private-key-file

O caminho do arquivo que contém uma chave privada de certificado formatada em PEM a ser usada no SQL Server.

--cert-public-key-file

O caminho do arquivo que contém uma chave pública de certificado formatada em PEM a ser usada no SQL Server.

--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.

--keytab-secret

O nome do segredo do Kubernetes que contém o arquivo keytab para essa instância gerenciada SQL habilitada 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 para esta instância gerenciada Os valores permitidos são: BasePrice, LicenseIncluded, DisasterRecovery.Default is 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 da 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 longa.

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 do 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.

--readable-secondaries

Número de réplicas a serem legíveis. Aplica-se somente ao nível Crítico de Negócios. 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 de Instância Gerenciada SQL que serão implantadas no cluster do Kubernetes para fins de alta disponibilidade.

valores aceitos: 1, 2, 3
--resource-group -g

O grupo de recursos do Azure no qual a Instância Gerenciada SQL habilitada para Arc existe.

--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á os backups automáticos para todos os bancos de dados na instância gerenciada SQL e todos os 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

O nome do segredo do Kubernetes a ser gerado, que hospeda ou hospedará o certificado de serviço SQL.

--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.

valores aceitos: -1, 0, 1, 2
--tde-mode

O modo TDE (Transparent Data Encryption) para essa instância gerenciada SQL habilitada para Arc. Valores permitidos: ServiceManaged, CustomerManage ou Disabled. O padrão é Desabilitado.

--tde-protector-private-key-file

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

--tde-protector-public-key-file

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

--tde-protector-secret

O nome do segredo do Kubernetes que contém o certificado do protetor TDE e a chave privada para essa instância gerenciada SQL habilitada para Arc. Só pode ser especificado para o modo TDE CustomerManaged .

--tier -t

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

--time-zone

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

--trace-flags

Lista separada por vírgulas de sinalizadores de rastreamento. Sem sinalizadores por padrão.

--use-k8s

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

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az sql mi-arc upgrade

Atualize a instância gerenciada de SQL.

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

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

Exemplos

Atualize a instância gerenciada de SQL.

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

Parâmetros Opcionais

--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 na verdade 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.

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.

--label-filter -l

Filtre para selecionar a instância a ser atualizada com base em 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 longa.

valor padrão: False
--resource-group -g

O grupo de recursos do Azure no qual a Instância Gerenciada SQL habilitada para Arc de destino existe.

--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 as APIs locais do Kubernetes para executar essa ação.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.