Partilhar via


az sql db ltr-backup

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.

Core disponibilidade geral
az sql db ltr-backup list

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

Core disponibilidade geral
az sql db ltr-backup restore

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

Core disponibilidade geral
az sql db ltr-backup show

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

Core disponibilidade geral
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.

Core disponibilidade geral

az sql db ltr-backup delete

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--yes -y

Não solicite confirmação.

Propriedade Valor
Default value: False
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 db ltr-backup list

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 --state]
                          [--latest --only-latest-per-database]
                          [--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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

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 db ltr-backup restore

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 --bsr]
                             [--capacity]
                             [--compute-model {Provisioned, Serverless}]
                             [--edition --tier]
                             [--elastic-pool]
                             [--encryption-protector]
                             [--encryption-protector-auto-rotation --epauto {false, true}]
                             [--family]
                             [--federated-client-id]
                             [--ha-replicas --read-replicas]
                             [--keys]
                             [--license-type {BasePrice, LicenseIncluded}]
                             [--min-capacity]
                             [--no-wait]
                             [--preferred-enclave-type {Default, VBS}]
                             [--read-scale {Disabled, Enabled}]
                             [--service-level-objective --service-objective]
                             [--tags]
                             [--umi --user-assigned-identity-id]
                             [--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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--assign-identity -i

Atribua identidade para o banco de dados.

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

Propriedade Valor
Parameter group: Serverless offering Arguments
--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.

Propriedade Valor
Parameter group: Performance Level (components) Arguments
--compute-model

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

Propriedade Valor
Parameter group: Serverless offering Arguments
Valores aceites: Provisioned, Serverless
--edition --tier -e

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

Propriedade Valor
Parameter group: Performance Level (components) Arguments
--elastic-pool

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

Propriedade Valor
Parameter group: Performance Level Arguments
--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.

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

Propriedade Valor
Parameter group: Performance Level (components) Arguments
--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.

Propriedade Valor
Valores aceites: BasePrice, LicenseIncluded
--min-capacity

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

Propriedade Valor
Parameter group: Serverless offering Arguments
--no-wait

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

Propriedade Valor
Default value: False
--preferred-enclave-type

Especifica o tipo de enclave para este recurso.

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

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

Propriedade Valor
Parameter group: Performance Level Arguments
--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.

Propriedade Valor
Valores aceites: false, true
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 db ltr-backup show

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.

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 db ltr-backup wait

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

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

Propriedade Valor
Parameter group: Wait Condition Arguments
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'].

Propriedade Valor
Parameter group: Wait Condition Arguments
--deleted

Aguarde até ser excluído.

Propriedade Valor
Parameter group: Wait Condition Arguments
Default value: False
--exists

Aguarde até que o recurso exista.

Propriedade Valor
Parameter group: Wait Condition Arguments
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 que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

Propriedade Valor
Parameter group: Resource Id Arguments
--interval

Intervalo de sondagem em segundos.

Propriedade Valor
Parameter group: Wait Condition Arguments
Default value: 30
--name -n

Nome do Banco de Dados SQL do Azure.

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Parameter group: Resource Id Arguments
--server -s

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

Propriedade Valor
Parameter group: Resource Id Arguments
--subscription

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

Propriedade Valor
Parameter group: Resource Id Arguments
--timeout

Espera máxima em segundos.

Propriedade Valor
Parameter group: Wait Condition Arguments
Default value: 3600
--updated

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

Propriedade Valor
Parameter group: Wait Condition Arguments
Default value: False
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.

--verbose

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

Propriedade Valor
Default value: False