Partilhar via


az sql mi-arc

Observação

Esta referência faz parte da extensão arcdata para o 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.

Gerir instâncias geridas SQL com Azure Arc.

Comandos

Name Description Tipo Status
az sql mi-arc config

Comandos de configuração.

Extensão disponibilidade geral
az sql mi-arc config add

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

Extensão disponibilidade geral
az sql mi-arc config init

Inicialize os ficheiros CRD e de especificação para uma instância gerida por SQL.

Extensão disponibilidade geral
az sql mi-arc config patch

Corrige um ficheiro de configuração com base num ficheiro de patch json.

Extensão disponibilidade geral
az sql mi-arc config remove

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

Extensão disponibilidade geral
az sql mi-arc config replace

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

Extensão disponibilidade geral
az sql mi-arc create

Crie uma instância gerenciada pelo SQL.

Extensão disponibilidade geral
az sql mi-arc delete

Exclua uma instância gerenciada pelo SQL.

Extensão disponibilidade geral
az sql mi-arc endpoint

Visualize e gerencie pontos de extremidade SQL.

Extensão disponibilidade geral
az sql mi-arc endpoint list

Liste os pontos de extremidade SQL.

Extensão disponibilidade geral
az sql mi-arc get-mirroring-cert

Recuperar o endpoint de espelhamento do grupo de certificado de disponibilidade a partir do sql mi e armazenar num ficheiro.

Extensão disponibilidade geral
az sql mi-arc list

Listar instâncias gerenciadas SQL.

Extensão disponibilidade geral
az sql mi-arc reprovision-replica

Reprovisionar uma réplica numa instância gerida por SQL.

Extensão disponibilidade geral
az sql mi-arc show

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

Extensão disponibilidade geral
az sql mi-arc update

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

Extensão disponibilidade geral
az sql mi-arc upgrade

Atualizar a instância gerida SQL.

Extensão disponibilidade geral

az sql mi-arc create

Crie uma instância gerenciada pelo SQL.

Para definir a palavra-passe da instância gerida 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 gerida SQL através da API Kubernetes.

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

Cria uma instância gerida SQL com 3 réplicas no cenário HA através da API Kubernetes.

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

Crie uma instância gerida SQL através do Azure Resource Manager (ARM).

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

Crie uma instância gerida SQL com autenticação Active Directory através da API 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 Obrigatórios

--name -n

O nome da instância gerenciada pelo SQL.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

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

O nome da conta do Active Directory para esta SQL Managed Instance habilitada pelo Arc. Esta conta precisa de ser criada antes da implementação desta instância.

--ad-connector-name

O nome do Active Directory Connector. Este parâmetro indica uma intenção de implementar com suporte AD.

--ad-encryption-types

Uma lista separada por vírgulas dos tipos de encriptação do Active Directory suportados. Deve ser um subconjunto dos seguintes valores: RC4, AES128, AES256.

--admin-login-secret

Nome do segredo Kubernetes para gerar essa credencial de login de administrador de utilizador.

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

Ativa o agente SQL Server para a instância. O padrão está desativado. Os valores permitidos são 'verdadeiros' ou 'falsos'.

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

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

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

Caminho para o ficheiro que contém uma chave privada de certificado formatada em PEM a ser usada no SQL Server.

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

Caminho para o ficheiro contendo uma chave pública de certificado formatada em PEM a ser usada para o SQL Server.

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

O ID de referência de alteração relacionado para esta operação de recurso.

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

A colação do 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 esta ocasião.

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

Se isto for especificado, então é considerado uma instância de desenvolvimento e não será cobrado.

--k8s-namespace -k

Namespace onde a instância gerenciada SQL deve ser implantada. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

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

O nome do segredo Kubernetes que contém o ficheiro keytab desta SQL Managed Instance habilitada por Arc.

--labels

Lista separada por vírgulas dos rótulos da instância gerida SQL.

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

O local do SQL Server para qualquer identificador de língua suportado (LCID) para a instância.

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

O tipo de licença para se candidatar a esta instância gerida 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 gerida como um número inteiro seguido de Gi (gigabytes). Exemplo: 4Gi.

--memory-request

O pedido para a capacidade da instância gerida como um número inteiro seguido de 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 espere que a operação de longa duração termine.

Propriedade Valor
Default value: False
--orchestrator-replicas

O número de réplicas orquestradoras 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 SQL.

--primary-dns-name

O principal nome DNS do serviço exposto aos utilizadores finais para se ligarem a esta SQL Managed Instance compatível com Arc (por exemplo, sqlinstancename.contoso.com).

--primary-port-number

O número de porta onde o serviço principal está exposto aos utilizadores finais (por exemplo, 31433).

--private-key-file

Ficheiro de Chave Privada gerado pelo openSSL para usar como id de instância.

--readable-secondaries

Número de réplicas a tornar legíveis. Aplica-se apenas ao nível Business Critical tier. O valor deve estar entre 0 e o número de réplicas menos 1.

--replicas

Esta opção especifica o número de réplicas da SQL Managed Instance que serão implementadas no seu cluster Kubernetes para fins de alta disponibilidade. O padrão é 1 réplica para Uso Geral, 3 réplicas para Crítico de Negócio.

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

O grupo de recursos Azure ao qual deve ser adicionada a SQL Managed Instance habilitada por Arc.

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

Período de retenção de reserva, especificado em dias. Os valores permitidos são de 0 a 35. O padrão é 7. Definir o período de retenção para 0 desativa os backups automáticos de todas as bases de dados na instância gerida SQL e quaisquer backups anteriores serão eliminados.

--secondary-dns-name

O nome DNS do serviço secundário é exposto aos utilizadores finais para se ligarem a esta SQL Managed Instance compatível com Arc (por exemplo, sqlinstancename2.contoso.com).

--secondary-port-number

O número de porta em que o serviço secundário está exposto aos utilizadores finais (por exemplo, 31434).

--service-annotations

Lista de anotações separadas por vírgulas a aplicar a todos os serviços externos.

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

Nome do segredo Kubernetes para gerar esse que hospeda ou irá hospedar um certificado de serviço SQL.

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

Lista de rótulos separados por vírgulas a aplicar a todos os serviços externos.

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

O tipo para o serviço principal.

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

Lista de anotações separadas por vírgulas a aplicar 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) para ser usada para backups (/var/opt/mssql/backups). Se não for especificado nenhum valor, será usada a classe de armazenamento padrão.

--storage-class-data -d

A classe de armazenamento a ser usada para ficheiros 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 registos 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 etiquetas a aplicar 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 têm de ser sincronizadas para se comprometerem. Definir este valor para -1 definirá o número de secundários sincronizados necessários para '(# de réplicas - 1) / 2', arredondado para baixo.

Propriedade Valor
Default value: -1
Valores aceites: -1, 0, 1, 2
--tde-mode

O modo Encriptação de Dados Transparente (TDE) para esta SQL Managed Instance habilitada por Arc. Valores permitidos: ServiceManaged, CustomerManaged ou Disabled. O padrão é Desativado.

--tde-protector-private-key-file

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

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

Caminho para o ficheiro contendo uma chave pública de certificado formatada em PEM a ser usada para TDE.

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

O nome do segredo Kubernetes que contém o certificado protetor TDE e a chave privada desta SQL Managed Instance habilitada por Arc. Só pode ser especificado para o modo TDE Gestão do Cliente.

--tier -t

O nível de preço para a instância. Valores permitidos: BusinessCritical (bc para abreviar) ou GeneralPurpose (gp para abreviar). O padrão é Uso Geral.

--time-zone

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

--trace-flags

Lista separada por vírgulas de traceflags. Sem bandeiras por defeito.

--use-k8s

Crie uma instância gerida 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 (kilobytes), 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 (kilobytes), 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 (kilobytes), 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 (kilobytes), Mi (megabytes) ou Gi (gigabytes).

--volume-size-orchestrator-logs

O tamanho do volume de armazenamento a ser usado para registos do orquestrador é um número positivo seguido de Ki (kilobytes), Mi (megabytes) ou Gi (gigabytes).

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az sql mi-arc delete

Exclua uma instância gerenciada pelo SQL.

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

Exemplos

Eliminar uma instância gerida SQL através da API Kubernetes.

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

Elimine uma instância gerida por SQL através do Azure Resource Manager (ARM).

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

Parâmetros Obrigatórios

--name -n

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

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

O ID de referência de alteração relacionado para esta operação de recurso.

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

Namespace onde a instância gerenciada SQL deve ser implantada. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

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

Não espere que a operação de longa duração termine.

Propriedade Valor
Default value: False
--resource-group -g

O grupo de recursos do Azure onde existe a SQL Managed Instance habilitada pelo Arc.

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

Use APIs locais do Kubernetes para realizar esta ação.

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az sql mi-arc get-mirroring-cert

Recuperar o endpoint de espelhamento do grupo de certificado de disponibilidade a partir do sql mi e armazenar num ficheiro.

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

Exemplos

Recuperar o endpoint de espelhamento do grupo de certificado de disponibilidade a partir do sqlmi1 e armazenar no ficheiro ficheiroName1

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

Parâmetros Obrigatórios

--cert-file

O nome local do ficheiro para armazenar o certificado recuperado em formato PEM.

--name -n

O nome da instância gerenciada pelo SQL.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

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

O ID de referência de alteração relacionado para esta operação de recurso.

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

Namespace onde a instância gerenciada SQL deve ser implantada. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

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

Use APIs locais do Kubernetes para realizar esta ação.

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az sql mi-arc list

Listar instâncias gerenciadas SQL.

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

Exemplos

Listar instâncias gerenciadas 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 tornar-se necessários para que o comando seja executado com êxito.

--custom-location

O local personalizado onde as Instâncias SQL Geridas com Arc-Enabled são implementadas. 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 espaço de nomes Kubernetes que contém as Instâncias SQL Geridas com Arc. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

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

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

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

Use APIs locais do Kubernetes para realizar esta ação.

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az sql mi-arc reprovision-replica

Reprovisionar uma réplica numa instância gerida por SQL.

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

Exemplos

Exemplo 1 - Reprovisionar a réplica 1 da instância gerida SQL sqlmi1.

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

Parâmetros Obrigatórios

--name -n

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

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

O ID de referência de alteração relacionado para esta operação de recurso.

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

Namespace onde a réplica da instância gerida por SQL é implementada. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

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

Não espere que a operação de longa duração termine.

Propriedade Valor
Default value: False
--use-k8s

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

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az sql mi-arc show

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

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

Exemplos

Mostre os detalhes de uma SQL Managed Instance usando a API Kubernetes.

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

Mostre os detalhes de uma SQL Managed Instance consultando o Azure Resource Manager (ARM).

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

Parâmetros Obrigatórios

--name -n

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--k8s-namespace -k

Namespace onde a instância gerenciada SQL deve ser implantada. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

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

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

--resource-group -g

O grupo de recursos do Azure onde existe a SQL Managed Instance habilitada pelo Arc.

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

Use APIs locais do Kubernetes para realizar esta ação.

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az sql mi-arc update

Atualize a configuração de uma instância gerida em 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 gerida em SQL.

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

Parâmetros Obrigatórios

--name -n

O nome da instância gerenciada SQL que está sendo editada. O nome sob o 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 tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

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

Uma lista separada por vírgulas dos tipos de encriptação do Active Directory suportados. Deve ser um subconjunto dos seguintes valores: RC4, AES128, AES256.

--agent-enabled

Ativa o agente SQL Server para a instância. O padrão está desativado.

--annotations

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

--cert-private-key-file

Caminho para o ficheiro que contém uma chave privada de certificado formatada em PEM a ser usada no SQL Server.

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

Caminho para o ficheiro contendo uma chave pública de certificado formatada em PEM a ser usada para o SQL Server.

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

O ID de referência de alteração relacionado 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 onde a instância gerenciada SQL deve ser implantada. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

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

O nome do segredo Kubernetes que contém o ficheiro keytab desta SQL Managed Instance habilitada por Arc.

--labels

Lista separada por vírgulas dos rótulos da instância gerida SQL.

--license-type -l

O tipo de licença para se candidatar a esta instância gerida 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 gerida como um número inteiro seguido de Gi (gigabytes). Exemplo: 4Gi.

--memory-request

O pedido para a capacidade da instância gerida como um número inteiro seguido de Gi (gigabytes). Exemplo: 4Gi.

--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Default value: False
--orchestrator-replicas

O número de réplicas orquestradoras 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 SQL.

--preferred-primary-replica

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

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

Número de réplicas a tornar legíveis. Aplica-se apenas ao nível Business Critical tier. O valor deve estar entre 0 e o número de réplicas menos 1.

--replicas

Esta opção especifica o número de réplicas da SQL Managed Instance que serão implementadas no seu cluster Kubernetes para fins de alta disponibilidade.

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

O grupo de recursos do Azure onde existe a SQL Managed Instance habilitada pelo Arc.

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

Período de retenção de reserva, especificado em dias. Os valores permitidos são de 0 a 35. O padrão é 7. Definir o período de retenção para 0 desativa os backups automáticos de todas as bases de dados na instância gerida SQL e quaisquer backups anteriores serão eliminados.

--service-annotations

Lista de anotações separadas por vírgulas a aplicar a todos os serviços externos.

--service-cert-secret

Nome do segredo Kubernetes para gerar esse que hospeda ou irá hospedar um certificado de serviço SQL.

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

Lista de rótulos separados por vírgulas a aplicar a todos os serviços externos.

--sync-secondary-to-commit

Número de réplicas secundárias que têm de ser sincronizadas para se comprometerem. Definir este valor para -1 definirá o número de secundários sincronizados necessários para '(# de réplicas - 1) / 2', arredondado para baixo.

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

O modo Encriptação de Dados Transparente (TDE) para esta SQL Managed Instance habilitada por Arc. Valores permitidos: ServiceManaged, CustomerManaged ou Disabled. O padrão é Desativado.

--tde-protector-private-key-file

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

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

Caminho para o ficheiro contendo uma chave pública de certificado formatada em PEM a ser usada para TDE.

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

O nome do segredo Kubernetes que contém o certificado protetor TDE e a chave privada desta SQL Managed Instance habilitada por Arc. Só pode ser especificado para o modo TDE Gestão do Cliente.

--tier -t

O nível de preço para a instância. Valores permitidos: BusinessCritical (bc para abreviar) ou GeneralPurpose (gp para abreviar). O padrão é Uso Geral.

--time-zone

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

--trace-flags

Lista separada por vírgulas de traceflags. Sem bandeiras por defeito.

--use-k8s

Use APIs locais do Kubernetes para realizar esta ação.

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az sql mi-arc upgrade

Atualizar a instância gerida SQL.

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

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 gerida 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 tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

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

O ID de referência de alteração relacionado 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 atualizar. Opcional, se não for especificada a versão, será utilizada a versão do controlador de dados. Especifique 'auto' para atualizar automaticamente para a versão mais recente e válida. 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 realmente as instâncias.

--field-filter -f

Filtra para selecionar instâncias a atualizar com base nas propriedades dos recursos.

--force

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

Propriedade Valor
Default value: False
--k8s-namespace -k

Namespace onde a instância gerenciada SQL deve ser implantada. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

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

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

--name -n

O nome da instância gerenciada pelo SQL.

--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Default value: False
--resource-group -g

O grupo de recursos do Azure onde existe a SQL Managed Instance habilitada por Arc-enabled.

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

A opção '--target' foi descontinuada e será removida numa versão futura. Usa '--versão desejada' em vez disso.

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

--use-k8s

Use APIs locais do Kubernetes para realizar esta ação.

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False