Partilhar via

az sql db ltr-backup

  • Referência

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

Comandos

Name 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 banco de dados.

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

Parâmetros Obrigatórios

--database -d

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

--location -l

A localização 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.

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

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

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

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

Liste 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 Obrigatórios

--location -l

A localização 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 nesse banco de dados.

--database-state --state

'Todos', 'Ao vivo' ou 'Excluído'. Buscará backups somente de bancos de dados de estado especificado. Se nenhum estado for fornecido, o padrão será 'Todos'.

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

Se verdadeiro, 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 de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

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

Restaure 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 Obrigatórios

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

--dest-database

Nome do banco de dados que será criado como 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

Atribua identidade para o banco de dados.

Valores aceites: 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á desativada.

--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 em número inteiro de DTUs ou vcores.

--compute-model

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

Valores aceites: 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 id de 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 do banco de dados. Pode ser verdadeiro, falso ou nulo.

Valores aceites: false, true
--family -f

O componente de geração de computação do sku (apenas 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. Apenas 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 para este banco de dados. LicenseIncluded se precisar de uma licença ou BasePricese tiver uma licença e estiver qualificado para o Azure HybridBenefit.

Valores aceites: BasePrice, LicenseIncluded
--min-capacity

Capacidade mínima que o banco de dados sempre terá alocado, se não pausado.

--no-wait

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

Default value: False
--preferred-enclave-type

Especifica o tipo de enclave para este recurso.

Valores aceites: Default, VBS
--read-scale

Se habilitada, as conexões que têm a intenção do aplicativo definida como somente leitura em sua cadeia de conexão podem ser roteadas para uma réplica secundária somente leitura. Esta propriedade só é configurável para bancos de dados Premium e Business Critical.

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

O objetivo de 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

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

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

A lista de identidade atribuída ao usuário para o Banco de dados SQL.

--zone-redundant -z

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

Valores aceites: false, true
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

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 Obrigatórios

--database -d

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

--location -l

A localização 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 de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

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

Default value: False
--custom

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

--deleted

Aguarde até ser excluído.

Default value: False
--exists

Aguarde até que o recurso exista.

Default value: False
--expand

Os recursos da criança para incluir na resposta. O valor padrão é Nenhum.

--filter

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

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--interval

Intervalo de sondagem em segundos.

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

--timeout

Espera máxima em segundos.

Default value: 3600
--updated

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

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.