Compartir a través de

az sql db ltr-backup

  • Vista previa
  • Referencia

Este grupo de comandos está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Administrar copias de seguridad de retención a largo plazo de SQL Database.

Comandos

Nombre Description Tipo Estado
az sql db ltr-backup delete

Elimine una copia de seguridad de retención a largo plazo.

 Core Versión preliminar
az sql db ltr-backup list

Enumere las copias de seguridad de retención a largo plazo para una ubicación, un servidor o una base de datos.

 Core Versión preliminar
az sql db ltr-backup restore

Restaure una copia de seguridad de retención a largo plazo en una nueva base de datos.

 Core Versión preliminar
az sql db ltr-backup show

Obtenga una copia de seguridad de retención a largo plazo para una base de datos.

 Core Versión preliminar
az sql db ltr-backup wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición de la base de datos.

 Core Versión preliminar

az sql db ltr-backup delete

Editar
Vista previa

El grupo de comandos "sql db ltr-backup" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Elimine una copia de seguridad de retención a largo plazo.

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

Ejemplos

Elimine la copia de seguridad de retención a largo plazo para la base de datos.

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

Parámetros requeridos

--database -d

Nombre de Azure SQL Database. Si se especifica (junto con el nombre del servidor), recupera todas las copias de seguridad solicitadas en esta base de datos.

--location -l

Ubicación de las copias de seguridad deseadas.

--name -n

Nombre de la copia de seguridad de LTR. Use "az sql db ltr-backup show" o "az sql db ltr-backup list" para el nombre de copia de seguridad.

--server -s

Nombre de Azure SQL Server. Si se especifica, recupera todas las copias de seguridad solicitadas en este servidor.

Parámetros opcionales

--yes -y

No solicita confirmación.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sql db ltr-backup list

Editar
Vista previa

El grupo de comandos "sql db ltr-backup" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumere las copias de seguridad de retención a largo plazo para una ubicación, un servidor o una base de datos.

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

Ejemplos

Enumeración de copias de seguridad de retención a largo plazo para una base de datos.

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

Enumere las copias de seguridad de retención a largo plazo para un servidor (enumere solo las copias de seguridad ltR más recientes, que pertenecen a bases de datos activas).

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

Enumeración de copias de seguridad de retención a largo plazo para un servidor (con el argumento del grupo de recursos).

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

Enumera las copias de seguridad de retención a largo plazo para una ubicación (enumera solo las copias de seguridad ltR más recientes, que pertenecen a bases de datos activas).

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

Enumeración de copias de seguridad de retención a largo plazo para una ubicación (con el argumento del grupo de recursos).

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

Parámetros requeridos

--location -l

Ubicación de las copias de seguridad deseadas.

Parámetros opcionales

--database -d

Nombre de Azure SQL Database. Si se especifica (junto con el nombre del servidor), recupera todas las copias de seguridad solicitadas en esta base de datos.

--database-state --state

'All', 'Live' o 'Deleted'. Capturará copias de seguridad solo de las bases de datos del estado especificado. Si no se provió ningún estado, el valor predeterminado es "All".

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

Si es true, solo devolverá la copia de seguridad más reciente para cada base de datos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--server -s

Nombre de Azure SQL Server. Si se especifica, recupera todas las copias de seguridad solicitadas en este servidor.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sql db ltr-backup restore

Editar
Vista previa

El grupo de comandos "sql db ltr-backup" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Restaure una copia de seguridad de retención a largo plazo en una nueva base de datos.

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}]

Ejemplos

Restaure la copia de seguridad de 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 requeridos

--backup-id

Identificador de recurso de la copia de seguridad de retención a largo plazo que se va a restaurar. Use "az sql db ltr-backup show" o "az sql db ltr-backup list" para el identificador de copia de seguridad.

--dest-database

Nombre de la base de datos que se creará como destino de restauración.

--dest-resource-group

Nombre del grupo de recursos del servidor al que se va a restaurar la base de datos.

--dest-server

Nombre del servidor al que se va a restaurar la base de datos.

Parámetros opcionales

--assign-identity -i

Asignar identidad para la base de datos.

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

Hora en minutos después de la cual la base de datos se pausa automáticamente. Un valor de -1 significa que la pausa automática está deshabilitada.

--availability-zone

Zona de disponibilidad.

--backup-storage-redundancy --bsr

Redundancia de almacenamiento de copia de seguridad usada para almacenar copias de seguridad. Entre los valores permitidos se incluyen: Local, Zone, Geo, GeoZone.

--capacity -c

Componente de capacidad de la SKU en número entero de DTU o vcores.

--compute-model

Modelo de proceso de la base de datos.

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

Componente de edición de la SKU. Los valores permitidos incluyen: Básico, Estándar, Premium, GeneralPurpose, BusinessCritical, Hiperescala.

--elastic-pool

Nombre o identificador de recurso del grupo elástico en el que se va a crear la base de datos.

--encryption-protector

Especifica la clave del almacén de claves de Azure que se va a usar como clave de protector de cifrado de base de datos.

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

Especifica la marca de rotación automática de clave protector de cifrado de base de datos. Puede ser true, false o null.

Valores aceptados: false, true
--family -f

Componente de generación de proceso de la SKU (solo para SKU de núcleo virtual). Entre los valores permitidos se incluyen: Gen4, Gen5.

--federated-client-id

Identificador de cliente federado para SQL Database. Se usa para el escenario de CMK entre inquilinos.

--ha-replicas --read-replicas

Número de réplicas de alta disponibilidad que se van a aprovisionar para la base de datos. Solo se puede establecer para la edición hiperescala.

--keys

Lista de claves de AKV para SQL Database.

--license-type

Tipo de licencia que se va a solicitar para esta base de datos.LicenseIncluded si necesita una licencia o BasePricesi tiene una licencia y es apta para Azure HybridBenefit.

Valores aceptados: BasePrice, LicenseIncluded
--min-capacity

Capacidad mínima que la base de datos siempre tendrá asignada, si no está en pausa.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
--preferred-enclave-type

Especifica el tipo de enclave para este recurso.

Valores aceptados: Default, VBS
--read-scale

Si está habilitada, las conexiones que tienen intención de aplicación establecida en readonly en su cadena de conexión se pueden enrutar a una réplica secundaria de solo lectura. Esta propiedad solo se puede establecer para las bases de datos Premium y Crítico para la empresa.

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

Objetivo de servicio para la nueva base de datos. Por ejemplo: Básico, S0, P1, GP_Gen4_1, GP_S_Gen5_8, BC_Gen5_2, HS_Gen5_32.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

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

Lista de identidades asignadas por el usuario para SQL Database.

--zone-redundant -z

Especifica si se va a habilitar la redundancia de zona. El valor predeterminado es true si no se especifica ningún valor.

Valores aceptados: false, true
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sql db ltr-backup show

Editar
Vista previa

El grupo de comandos "sql db ltr-backup" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Obtenga una copia de seguridad de retención a largo plazo para una base de datos.

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

Ejemplos

Mostrar la copia de seguridad de retención a largo plazo para una base de datos.

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

Parámetros requeridos

--database -d

Nombre de Azure SQL Database. Si se especifica (junto con el nombre del servidor), recupera todas las copias de seguridad solicitadas en esta base de datos.

--location -l

Ubicación de las copias de seguridad deseadas.

--name -n

Nombre de la copia de seguridad de LTR. Use "az sql db ltr-backup show" o "az sql db ltr-backup list" para el nombre de copia de seguridad.

--server -s

Nombre de Azure SQL Server. Si se especifica, recupera todas las copias de seguridad solicitadas en este servidor.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sql db ltr-backup wait

Editar
Vista previa

El grupo de comandos "sql db ltr-backup" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Coloque la CLI en un estado de espera hasta que se cumpla una condición de la base de datos.

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

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Valor predeterminado: False
--expand

Los recursos secundarios que se van a incluir en la respuesta. El valor predeterminado es None.

--filter

Expresión de filtro de OData que filtra los elementos de la colección. El valor predeterminado es None.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--interval

Intervalo de sondeo en segundos.

Valor predeterminado: 30
--name -n

Nombre de Azure SQL Database.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--server -s

Nombre de Azure SQL Server. Puede configurar el valor predeterminado mediante az configure --defaults sql-server=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--timeout

Espera máxima en segundos.

Valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.