Compartilhar via

az sql db ltr-backup

  • Referência

Gerenciar backups de retenção de longo prazo do banco de dados SQL.

Comandos

Nome Description Tipo Status
az sql db ltr-backup delete

Exclua um backup de retenção de longo prazo.

 Núcleo GA
az sql db ltr-backup list

Liste os backups de retenção de longo prazo para um local, servidor ou banco de dados.

 Núcleo GA
az sql db ltr-backup restore

Restaure um backup de retenção de longo prazo para um novo banco de dados.

 Núcleo GA
az sql db ltr-backup show

Obtenha um backup de retenção de longo prazo para um banco de dados.

 Núcleo GA
az sql db ltr-backup wait

Coloque a CLI em um estado de espera até que uma condição do banco de dados seja atendida.

 Núcleo GA

az sql db ltr-backup delete

Editar

Exclua um backup de retenção de longo prazo.

az sql db ltr-backup delete --database
                            --location
                            --name
                            --server
                            [--yes]

Exemplos

Exclua o backup de retenção de longo prazo para o banco de dados.

az sql db ltr-backup delete -l southeastasia -s myserver -d mydb -n "3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000"

Parâmetros Exigidos

--database -d

Nome do Banco de Dados SQL do Azure. Se especificado (juntamente com o nome do servidor), recupera todos os backups solicitados neste banco de dados.

--location -l

O local dos backups desejados.

--name -n

O nome do backup LTR. Use 'az sql db ltr-backup show' ou 'az sql db ltr-backup list' para o nome do backup.

--server -s

Nome do SQL Server do Azure. Se especificado, recupera todos os backups solicitados neste servidor.

Parâmetros Opcionais

--yes -y

Não solicite confirmação.

Valor padrão: False
Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az sql db ltr-backup list

Editar

Liste os backups de retenção de longo prazo para um local, servidor ou banco de dados.

az sql db ltr-backup list --location
                          [--database]
                          [--database-state]
                          [--latest]
                          [--resource-group]
                          [--server]

Exemplos

Listar backups de retenção de longo prazo para um banco de dados.

az sql db ltr-backup list -l southeastasia -s myserver -d mydb

Liste backups de retenção de longo prazo para um servidor (liste apenas os backups LTR mais recentes, que pertencem a bancos de dados dinâmicos).

az sql db ltr-backup list -l southeastasia -s myserver --database-state Live --only-latest-per-database True

Listar backups de retenção de longo prazo para um servidor (com argumento de grupo de recursos).

az sql db ltr-backup list -l southeastasia -g mygroup -s myserver

Liste backups de retenção de longo prazo para um local (liste apenas os backups ltr mais recentes, que pertencem a bancos de dados dinâmicos).

az sql db ltr-backup list -l southeastasia --database-state Live --only-latest-per-database True

Listar backups de retenção de longo prazo para um local (com argumento de grupo de recursos).

az sql db ltr-backup list -l southeastasia -g mygroup

Parâmetros Exigidos

--location -l

O local dos backups desejados.

Parâmetros Opcionais

--database -d

Nome do Banco de Dados SQL do Azure. Se especificado (juntamente com o nome do servidor), recupera todos os backups solicitados neste banco de dados.

--database-state --state

'All', 'Live' ou 'Deleted'. Buscará backups somente de bancos de dados de estado especificado. Se nenhum estado for provido, o padrão será 'All'.

--latest --only-latest-per-database

Se for true, retornará apenas o backup mais recente para cada banco de dados.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--server -s

Nome do SQL Server do Azure. Se especificado, recupera todos os backups solicitados neste servidor.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az sql db ltr-backup restore

Editar

Restaure um backup de retenção de longo prazo para um novo banco de dados.

az sql db ltr-backup restore --backup-id
                             --dest-database
                             --dest-resource-group
                             --dest-server
                             [--assign-identity {false, true}]
                             [--auto-pause-delay]
                             [--availability-zone]
                             [--backup-storage-redundancy]
                             [--capacity]
                             [--compute-model {Provisioned, Serverless}]
                             [--edition]
                             [--elastic-pool]
                             [--encryption-protector]
                             [--encryption-protector-auto-rotation {false, true}]
                             [--family]
                             [--federated-client-id]
                             [--ha-replicas]
                             [--keys]
                             [--license-type {BasePrice, LicenseIncluded}]
                             [--min-capacity]
                             [--no-wait]
                             [--preferred-enclave-type {Default, VBS}]
                             [--read-scale {Disabled, Enabled}]
                             [--service-level-objective]
                             [--tags]
                             [--umi]
                             [--zone-redundant {false, true}]

Exemplos

Restaurar o backup ltr.

az sql db ltr-backup restore \
--dest-database targetdb --dest-server myserver --dest-resource-group mygroup \
--backup-id "/subscriptions/6caa113c-794c-42f8-ab9d-878d8aa104dc/resourceGroups/mygroup/providers/Microsoft.Sql/locations/southeastasia/longTermRetentionServers/myserver/longTermRetentionDatabases/sourcedb/longTermRetentionBackups/3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000"

Parâmetros Exigidos

--backup-id

A ID do recurso do backup de retenção de longo prazo a ser restaurado. Use 'az sql db ltr-backup show' ou 'az sql db ltr-backup list' para id de backup.

--dest-database

Nome do banco de dados que será criado como o destino de restauração.

--dest-resource-group

Nome do grupo de recursos do servidor para o qual restaurar o banco de dados.

--dest-server

Nome do servidor para o qual restaurar o banco de dados.

Parâmetros Opcionais

--assign-identity -i

Atribuir identidade ao banco de dados.

Valores aceitos: false, true
--auto-pause-delay

Tempo em minutos após o qual o banco de dados é pausado automaticamente. Um valor de -1 significa que a pausa automática está desabilitada.

--availability-zone

Zona de disponibilidade.

--backup-storage-redundancy --bsr

Redundância de armazenamento de backup usada para armazenar backups. Os valores permitidos incluem: Local, Zone, Geo, GeoZone.

--capacity -c

O componente de capacidade do sku no número inteiro de DTUs ou vcores.

--compute-model

O modelo de computação do banco de dados.

Valores aceitos: Provisioned, Serverless
--edition --tier -e

O componente de edição do sku. Os valores permitidos incluem: Basic, Standard, Premium, GeneralPurpose, BusinessCritical, Hyperscale.

--elastic-pool

O nome ou a ID do recurso do pool elástico no qual criar o banco de dados.

--encryption-protector

Especifica a chave do cofre de chaves do Azure a ser usada como chave protetora de criptografia de banco de dados.

--encryption-protector-auto-rotation --epauto

Especifica o sinalizador de rotação automática da chave do protetor de criptografia de banco de dados. Pode ser verdadeiro, falso ou nulo.

Valores aceitos: false, true
--family -f

O componente de geração de computação do sku (somente para vcore skus). Os valores permitidos incluem: Gen4, Gen5.

--federated-client-id

A ID do cliente federado para o Banco de Dados SQL. Ele é usado para o cenário de CMK entre locatários.

--ha-replicas --read-replicas

O número de réplicas de alta disponibilidade a serem provisionadas para o banco de dados. Somente configurável para a edição Hyperscale.

--keys

A lista de chaves AKV para o Banco de Dados SQL.

--license-type

O tipo de licença a ser aplicado a esse banco de dados. LicenseIncluded se você precisar de uma licença ou BasePricese tiver uma licença e estiver qualificado para o Azure HybridBenefit.

Valores aceitos: BasePrice, LicenseIncluded
--min-capacity

Capacidade mínima que o banco de dados sempre alocará, se não estiver em pausa.

--no-wait

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

Valor padrão: False
--preferred-enclave-type

Especifica o tipo de enclave para esse recurso.

Valores aceitos: Default, VBS
--read-scale

Se habilitada, as conexões que têm a intenção do aplicativo definida como readonly na cadeia de conexão podem ser roteadas para uma réplica somente leitura secundária. Essa propriedade só é configurável para bancos de dados Premium e Comercialmente Críticos.

Valores aceitos: Disabled, Enabled
--service-level-objective --service-objective

O objetivo do serviço para o novo banco de dados. Por exemplo: Basic, S0, P1, GP_Gen4_1, GP_S_Gen5_8, BC_Gen5_2, HS_Gen5_32.

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

--umi --user-assigned-identity-id

A lista de identidade atribuída pelo usuário para o Banco de Dados SQL.

--zone-redundant -z

Especifica se a redundância de zona deve ser habilitada. O padrão será verdadeiro se nenhum valor for especificado.

Valores aceitos: false, true
Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az sql db ltr-backup show

Editar

Obtenha um backup de retenção de longo prazo para um banco de dados.

az sql db ltr-backup show --database
                          --location
                          --name
                          --server

Exemplos

Mostrar backup de retenção de longo prazo para um banco de dados.

az sql db ltr-backup show -l southeastasia -s myserver -d mydb -n "3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000;Hot"

Parâmetros Exigidos

--database -d

Nome do Banco de Dados SQL do Azure. Se especificado (juntamente com o nome do servidor), recupera todos os backups solicitados neste banco de dados.

--location -l

O local dos backups desejados.

--name -n

O nome do backup LTR. Use 'az sql db ltr-backup show' ou 'az sql db ltr-backup list' para o nome do backup.

--server -s

Nome do SQL Server do Azure. Se especificado, recupera todos os backups solicitados neste servidor.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az sql db ltr-backup wait

Editar

Coloque a CLI em um estado de espera até que uma condição do banco de dados seja atendida.

az sql db ltr-backup wait [--created]
                          [--custom]
                          [--deleted]
                          [--exists]
                          [--expand]
                          [--filter]
                          [--ids]
                          [--interval]
                          [--name]
                          [--resource-group]
                          [--server]
                          [--subscription]
                          [--timeout]
                          [--updated]

Parâmetros Opcionais

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Valor padrão: False
--custom

Aguarde até que a condição atenda a uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

Valor padrão: False
--exists

Aguarde até que o recurso exista.

Valor padrão: False
--expand

Os recursos filho a serem incluídos na resposta. O valor padrão é None.

--filter

Uma expressão de filtro OData que filtra elementos na coleção. O valor padrão é None.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--interval

Intervalo de sondagem em segundos.

Valor padrão: 30
--name -n

Nome do Banco de Dados SQL do Azure.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--server -s

Nome do SQL Server do Azure. Você pode configurar o padrão usando az configure --defaults sql-server=<name>.

--subscription

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

--timeout

Espera máxima em segundos.

Valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

Valor padrão: False
Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.