az sql db ltr-backup

  • Préversion
  • Référence

Ce groupe de commandes est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Gérer les sauvegardes de rétention à long terme de la base de données SQL.

Commandes

Nom Description Type Statut
az sql db ltr-backup delete

Supprimez une sauvegarde de rétention à long terme.

 Core Aperçu
az sql db ltr-backup list

Répertoriez les sauvegardes de rétention à long terme pour un emplacement, un serveur ou une base de données.

 Core Aperçu
az sql db ltr-backup restore

Restaurez une sauvegarde de rétention à long terme sur une nouvelle base de données.

 Core Aperçu
az sql db ltr-backup show

Obtenir une sauvegarde de rétention à long terme pour une base de données.

 Core Aperçu
az sql db ltr-backup wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de la base de données soit remplie.

 Core Aperçu

az sql db ltr-backup delete

Modifier
Préversion

Le groupe de commandes « sql db ltr-backup » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Supprimez une sauvegarde de rétention à long terme.

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

Exemples

Supprimez la sauvegarde de rétention à long terme pour la base de données.

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

Paramètres obligatoires

--database -d

Nom d’Azure SQL Database. S’il est spécifié (ainsi que le nom du serveur), récupère toutes les sauvegardes demandées sous cette base de données.

--location -l

Emplacement des sauvegardes souhaitées.

--name -n

Nom de la sauvegarde LTR. Utilisez « az sql db ltr-backup show » ou « az sql db ltr-backup list » pour le nom de sauvegarde.

--server -s

Nom d’Azure SQL Server. Si elle est spécifiée, récupère toutes les sauvegardes demandées sous ce serveur.

Paramètres facultatifs

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az sql db ltr-backup list

Modifier
Préversion

Le groupe de commandes « sql db ltr-backup » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Répertoriez les sauvegardes de rétention à long terme pour un emplacement, un serveur ou une base de données.

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

Exemples

Répertorier les sauvegardes de rétention à long terme pour une base de données.

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

Répertorier les sauvegardes de rétention à long terme pour un serveur (répertorier uniquement les dernières sauvegardes LTR, qui appartiennent aux bases de données actives).

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

Répertorier les sauvegardes de rétention à long terme pour un serveur (avec l’argument groupe de ressources).

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

Répertorier les sauvegardes de rétention à long terme pour un emplacement (lister uniquement les dernières sauvegardes LTR, qui appartiennent aux bases de données actives).

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

Répertorier les sauvegardes de rétention à long terme pour un emplacement (avec l’argument groupe de ressources).

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

Paramètres obligatoires

--location -l

Emplacement des sauvegardes souhaitées.

Paramètres facultatifs

--database -d

Nom d’Azure SQL Database. S’il est spécifié (ainsi que le nom du serveur), récupère toutes les sauvegardes demandées sous cette base de données.

--database-state --state

'All', 'Live' ou 'Deleted'. Récupère les sauvegardes uniquement à partir de bases de données d’état spécifié. Si aucun état n’est provié, la valeur par défaut est « All ».

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

Si la valeur est true, retourne uniquement la dernière sauvegarde pour chaque base de données.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--server -s

Nom d’Azure SQL Server. Si elle est spécifiée, récupère toutes les sauvegardes demandées sous ce serveur.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az sql db ltr-backup restore

Modifier
Préversion

Le groupe de commandes « sql db ltr-backup » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Restaurez une sauvegarde de rétention à long terme sur une nouvelle base de données.

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

Exemples

Restaurer la sauvegarde 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"

Paramètres obligatoires

--backup-id

ID de ressource de la sauvegarde de rétention à long terme à restaurer. Utilisez « az sql db ltr-backup show » ou « az sql db ltr-backup list » pour l’ID de sauvegarde.

--dest-database

Nom de la base de données qui sera créée en tant que destination de restauration.

--dest-resource-group

Nom du groupe de ressources du serveur dans lequel restaurer la base de données.

--dest-server

Nom du serveur dans lequel restaurer la base de données.

Paramètres facultatifs

--assign-identity -i

Attribuer une identité pour la base de données.

valeurs acceptées: false, true
--auto-pause-delay

Durée en minutes après laquelle la base de données est automatiquement suspendue. La valeur -1 signifie que la pause automatique est désactivée.

--availability-zone

Zone de disponibilité

--backup-storage-redundancy --bsr

Redondance du stockage de sauvegarde utilisée pour stocker les sauvegardes. Les valeurs autorisées sont les suivantes : Local, Zone, Geo, GeoZone.

--capacity -c

Composant de capacité de la référence SKU en nombre entier de DTU ou de vcores.

--compute-model

Modèle de calcul de la base de données.

valeurs acceptées: Provisioned, Serverless
--edition --tier -e

Composant d’édition de la référence SKU. Les valeurs autorisées sont les suivantes : De base, Standard, Premium, GeneralPurpose, BusinessCritical, Hyperscale.

--elastic-pool

Nom ou ID de ressource du pool élastique dans lequel créer la base de données.

--encryption-protector

Spécifie la clé du coffre de clés Azure à utiliser comme clé de protecteur de chiffrement de base de données.

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

Spécifie l’indicateur de rotation automatique de la clé de protection du chiffrement de base de données. Peut être true, false ou null.

valeurs acceptées: false, true
--family -f

Composant de génération de calcul de la référence SKU (pour les références SKU vcore uniquement). Les valeurs autorisées sont les suivantes : Gen4, Gen5.

--federated-client-id

ID client fédéré pour la base de données SQL. Il est utilisé pour le scénario CMK interlocataire.

--ha-replicas --read-replicas

Nombre de réplicas à haute disponibilité à approvisionner pour la base de données. Uniquement settable pour l’édition Hyperscale.

--keys

Liste des clés AKV pour la base de données SQL.

--license-type

Type de licence à appliquer pour cette base de données.LicenseIncluded si vous avez besoin d’une licence, ou BasePricesi vous disposez d’une licence et que vous êtes éligible à Azure HybridBenefit.

valeurs acceptées: BasePrice, LicenseIncluded
--min-capacity

Capacité minimale que la base de données aura toujours allouée, si elle n’est pas suspendue.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
--preferred-enclave-type

Spécifie le type d’enclave pour cette ressource.

valeurs acceptées: Default, VBS
--read-scale

Si cette option est activée, les connexions dont l’intention d’application est définie en lecture seule dans leur chaîne de connexion peuvent être routées vers un réplica secondaire en lecture seule. Cette propriété est uniquement paramétrable pour les bases de données Premium et Critique pour l’entreprise.

valeurs acceptées: Disabled, Enabled
--service-level-objective --service-objective

Objectif de service pour la nouvelle base de données. Par exemple : Basic, S0, P1, GP_Gen4_1, GP_S_Gen5_8, BC_Gen5_2, HS_Gen5_32.

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

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

Liste des identités affectées par l’utilisateur pour la base de données SQL.

--zone-redundant -z

Spécifie s’il faut activer la redondance de zone. La valeur par défaut est true si aucune valeur n’est spécifiée.

valeurs acceptées: false, true
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az sql db ltr-backup show

Modifier
Préversion

Le groupe de commandes « sql db ltr-backup » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Obtenir une sauvegarde de rétention à long terme pour une base de données.

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

Exemples

Afficher la sauvegarde de rétention à long terme pour une base de données.

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

Paramètres obligatoires

--database -d

Nom d’Azure SQL Database. S’il est spécifié (ainsi que le nom du serveur), récupère toutes les sauvegardes demandées sous cette base de données.

--location -l

Emplacement des sauvegardes souhaitées.

--name -n

Nom de la sauvegarde LTR. Utilisez « az sql db ltr-backup show » ou « az sql db ltr-backup list » pour le nom de sauvegarde.

--server -s

Nom d’Azure SQL Server. Si elle est spécifiée, récupère toutes les sauvegardes demandées sous ce serveur.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az sql db ltr-backup wait

Modifier
Préversion

Le groupe de commandes « sql db ltr-backup » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de la base de données soit remplie.

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

Paramètres facultatifs

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

valeur par défaut: False
--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState !='InProgress', instanceView.statuses[ ?code=='PowerState/running'].

--deleted

Attendez la suppression.

valeur par défaut: False
--exists

Attendez que la ressource existe.

valeur par défaut: False
--expand

Ressources enfants à inclure dans la réponse. La valeur par défaut est None.

--filter

Expression de filtre OData qui filtre les éléments de la collection. La valeur par défaut est None.

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--interval

Intervalle d’interrogation en secondes.

valeur par défaut: 30
--name -n

Nom d’Azure SQL Database.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--server -s

Nom d’Azure SQL Server. Vous pouvez configurer la valeur par défaut à l’aide az configure --defaults sql-server=<name>de .

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--timeout

Délai maximal d’attente en secondes.

valeur par défaut: 3600
--updated

Attendez la mise à jour avec provisioningState sur « Réussi ».

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.