Partager via


az sql mi-arc

Note

Cette référence fait partie de l’extension arcdata pour la Azure CLI (version 2.3.1 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une az sql mi-arc commande. Apprenez-en davantage sur les extensions.

Gérez les instances managées SQL compatibles avec Azure Arc.

Commandes

Nom Description Type État
az sql mi-arc config

Commandes de configuration.

Extension GA
az sql mi-arc config add

Ajoutez une valeur pour un chemin json dans un fichier config.

Extension GA
az sql mi-arc config init

Initialisez les fichiers CRD et de spécification pour une instance managée SQL.

Extension GA
az sql mi-arc config patch

Corrigez un fichier de configuration basé sur un fichier de correctif json.

Extension GA
az sql mi-arc config remove

Supprimez une valeur pour un chemin json dans un fichier config.

Extension GA
az sql mi-arc config replace

Remplacez une valeur pour un chemin json dans un fichier config.

Extension GA
az sql mi-arc create

Créez une instance SQL gérée.

Extension GA
az sql mi-arc delete

Supprimez une instance SQL gérée.

Extension GA
az sql mi-arc endpoint

Afficher et gérer les points de terminaison SQL.

Extension GA
az sql mi-arc endpoint list

Liste les points de terminaison SQL.

Extension GA
az sql mi-arc get-mirroring-cert

Récupérez le certificat du point de terminaison de mise en miroir de groupes de disponibilité à partir de sql mi et stockez-le dans un fichier.

Extension GA
az sql mi-arc list

Répertoriez les instances SQL gérées.

Extension GA
az sql mi-arc reprovision-replica

Reprovisionnez un réplica dans une instance managée SQL.

Extension GA
az sql mi-arc show

Affichez les détails d’une instance SQL gérée.

Extension GA
az sql mi-arc update

Mettez à jour la configuration d’une instance managée SQL.

Extension GA
az sql mi-arc upgrade

Mettez à niveau l’instance managée SQL.

Extension GA

az sql mi-arc create

Créez une instance SQL gérée.

Pour définir le mot de passe de l’instance managée SQL, définissez la variable d’environnement AZDATA_PASSWORD.

az sql mi-arc create --name
                     [--acquire-policy-token]
                     [--ad-account-name]
                     [--ad-connector-name]
                     [--ad-encryption-types]
                     [--admin-login-secret]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--change-reference]
                     [--collation]
                     [--cores-limit]
                     [--cores-request]
                     [--custom-location]
                     [--dev]
                     [--k8s-namespace]
                     [--keytab-secret]
                     [--labels]
                     [--language]
                     [--license-type]
                     [--memory-limit]
                     [--memory-request]
                     [--no-external-endpoint]
                     [--no-wait]
                     [--orchestrator-replicas]
                     [--path]
                     [--primary-dns-name]
                     [--primary-port-number]
                     [--private-key-file]
                     [--readable-secondaries]
                     [--replicas {1, 2, 3}]
                     [--resource-group]
                     [--retention-days]
                     [--secondary-dns-name]
                     [--secondary-port-number]
                     [--service-annotations]
                     [--service-cert-secret]
                     [--service-labels]
                     [--service-type {LoadBalancer, NodePort}]
                     [--storage-annotations]
                     [--storage-class-backups]
                     [--storage-class-data]
                     [--storage-class-datalogs]
                     [--storage-class-logs]
                     [--storage-class-orchestrator-logs]
                     [--storage-labels]
                     [--sync-secondary-to-commit {-1, 0, 1, 2}]
                     [--tde-mode]
                     [--tde-protector-private-key-file]
                     [--tde-protector-public-key-file]
                     [--tde-protector-secret]
                     [--tier]
                     [--time-zone]
                     [--trace-flags]
                     [--use-k8s]
                     [--volume-size-backups]
                     [--volume-size-data]
                     [--volume-size-datalogs]
                     [--volume-size-logs]
                     [--volume-size-orchestrator-logs]

Exemples

Créez une instance managée SQL via l’API Kubernetes.

az sql mi-arc create -n sqlmi1 --k8s-namespace arc --use-k8s

Créez une instance managée SQL avec 3 réplicas dans le scénario haute disponibilité via l’API Kubernetes.

az sql mi-arc create -n sqlmi2 --replicas 3 --k8s-namespace arc --use-k8s

Créez une instance managée SQL via Azure Resource Manager (ARM).

az sql mi-arc create --name sqlmi3 --resource-group rg-name --custom-location arc-cl

Créez une instance managée SQL avec Active Directory authentification via l’API Kubernetes.

az sql mi-arc create --name contososqlmi --k8s-namespace arc --ad-connector-name arcadc --ad-account-name arcuser --keytab-secret arcuser-keytab-secret --primary-dns-name contososqlmi-primary.contoso.local --primary-port-number 8143 --use-k8s

Paramètres obligatoires

--name -n

Nom de l’instance managée SQL.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--ad-account-name

Nom du compte Active Directory pour cette SQL Managed Instance avec Arc. Ce compte doit être créé avant le déploiement de cette instance.

--ad-connector-name

Nom du connecteur Active Directory. Ce paramètre indique une intention de déploiement avec la prise en charge d’AD.

--ad-encryption-types

Liste séparée par des virgules des types de chiffrement pris en charge Active Directory. Doit être un sous-ensemble des valeurs suivantes : RC4, AES128, AES256.

--admin-login-secret

Nom du secret Kubernetes pour générer ces hôtes ou hébergera les informations d’identification du compte de connexion administrateur de l’utilisateur.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--agent-enabled

Activez SQL Server agent pour l’instance. La valeur par défaut est désactivée. Les valeurs autorisées sont « true » ou « false ».

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--annotations

Liste séparée par des virgules des annotations de l’instance managée SQL.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--cert-private-key-file

Chemin d’accès au fichier contenant une clé privée de certificat au format PEM à utiliser pour SQL Server.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--cert-public-key-file

Chemin d’accès au fichier contenant une clé publique de certificat au format PEM à utiliser pour SQL Server.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--collation

Classement SQL Server de l’instance.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--cores-limit -c

Limite des cœurs de l’instance managée sous forme d’entier.

--cores-request

Demande de cœurs de l’instance managée sous forme d’entier.

--custom-location

Emplacement personnalisé de cette instance.

Propriété Valeur
Groupe de paramètres: Azure Resource Manager – targeted Arguments
--dev

Si cette valeur est spécifiée, elle est considérée comme une instance de développement et ne sera pas facturée.

--k8s-namespace -k

Espace de noms dans lequel l’instance managée SQL doit être déployée. Si aucun espace de noms n’est spécifié, l’espace de noms défini dans kubeconfig sera utilisé.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--keytab-secret

Nom du secret Kubernetes qui contient le fichier keytab pour cette SQL Managed Instance avec Arc.

--labels

Liste séparée par des virgules des étiquettes de l’instance managée SQL.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--language

Paramètres régionaux SQL Server à n’importe quel identificateur de langue (LCID) pris en charge pour l’instance.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--license-type -l

Le type de licence à appliquer pour ces valeurs autorisées d’instance managée est : BasePrice, LicenseIncluded, DisasterRecovery.Default est LicenseIncluded. Le type de licence peut être modifié..

--memory-limit -m

Limite de la capacité de l’instance managée sous la forme d’un nombre entier suivi de Gio (gigaoctets). Exemple : 4Gi.

--memory-request

Demande de capacité de l’instance managée sous la forme d’un nombre entier suivi de Gio (gigaoctets). Exemple : 4Gi.

--no-external-endpoint

Si spécifié, aucun service externe n’est créé. Sinon, un service externe est créé à l’aide du même type de service que le contrôleur de données.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--no-wait

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

Propriété Valeur
Valeur par défaut: False
--orchestrator-replicas

Nombre de réplicas d’orchestrateur à haute disponibilité. La valeur doit être comprise entre 1 et 3.

--path

Chemin d’accès au fichier azext_arcdata pour le fichier json de l’instance managée SQL.

--primary-dns-name

Nom DNS du service principal exposé aux utilisateurs finaux pour se connecter à cette SQL Managed Instance avec Arc (par exemple, sqlinstancename.contoso.com).

--primary-port-number

Numéro de port sur lequel le service principal est exposé aux utilisateurs finaux (par exemple, 31433).

--private-key-file

Fichier de clé privée généré par openSSL à utiliser comme ID d’instance.

--readable-secondaries

Nombre de réplicas à rendre lisibles. S’applique uniquement au niveau Critique pour l’entreprise. La valeur doit être comprise entre 0 et le nombre de réplicas moins 1.

--replicas

Cette option spécifie le nombre de réplicas SQL Managed Instance qui seront déployés dans votre cluster Kubernetes à des fins de haute disponibilité. La valeur par défaut est 1 réplica à usage général, 3 réplicas pour critique pour l’entreprise.

Propriété Valeur
Valeurs acceptées: 1, 2, 3
--resource-group -g

Groupe de ressources Azure auquel le SQL Managed Instance avec Arc doit être ajouté.

Propriété Valeur
Groupe de paramètres: Azure Resource Manager – targeted Arguments
--retention-days

Période de rétention de sauvegarde, spécifiée en jours. Les valeurs autorisées sont comprises entre 0 et 35. La valeur par défaut est 7. La définition de la période de rétention sur 0 désactive les sauvegardes automatiques pour toutes les bases de données sur l’instance managée SQL et toutes les sauvegardes antérieures seront supprimées.

--secondary-dns-name

Nom DNS du service secondaire exposé aux utilisateurs finaux pour se connecter à ce SQL Managed Instance avec Arc (par exemple, sqlinstancename2.contoso.com).

--secondary-port-number

Numéro de port sur lequel le service secondaire est exposé aux utilisateurs finaux (par exemple, 31434).

--service-annotations

Liste séparée par des virgules d’annotations à appliquer à tous les services externes.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--service-cert-secret

Nom du secret Kubernetes pour générer ces hôtes ou hébergera le certificat de service SQL.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--service-labels

Liste séparée par des virgules d’étiquettes à appliquer à tous les services externes.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--service-type

Type du service principal.

Propriété Valeur
Valeurs acceptées: LoadBalancer, NodePort
--storage-annotations

Liste séparée par des virgules d’annotations à appliquer à tous les PVC.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--storage-class-backups

Classe de stockage compatible ReadWriteMany (RWX) à utiliser pour les sauvegardes (/var/opt/mssql/backups). Si aucune valeur n’est spécifiée, la classe de stockage par défaut est utilisée.

--storage-class-data -d

Classe de stockage à utiliser pour les fichiers de données (.mdf, .ndf). Si aucune valeur n’est spécifiée, aucune classe de stockage n’est spécifiée, ce qui entraîne l’utilisation de Kubernetes à l’aide de la classe de stockage par défaut.

--storage-class-datalogs

Classe de stockage à utiliser pour les journaux de base de données (.ldf). Si aucune valeur n’est spécifiée, aucune classe de stockage n’est spécifiée, ce qui entraîne l’utilisation de Kubernetes à l’aide de la classe de stockage par défaut.

--storage-class-logs

Classe de stockage à utiliser pour les journaux (/var/log). Si aucune valeur n’est spécifiée, aucune classe de stockage n’est spécifiée, ce qui entraîne l’utilisation de Kubernetes à l’aide de la classe de stockage par défaut.

--storage-class-orchestrator-logs

Classe de stockage à utiliser pour les journaux d’orchestrateur (/var/log). Si aucune valeur n’est spécifiée, aucune classe de stockage n’est spécifiée, ce qui entraîne l’utilisation de Kubernetes à l’aide de la classe de stockage par défaut.

--storage-labels

Liste séparée par des virgules d’étiquettes à appliquer à tous les PVC.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--sync-secondary-to-commit

Nombre de réplicas secondaires qui doivent être synchronisés pour la validation. Si vous définissez cette valeur sur -1 définissez le nombre de secondaires synchronisés requis sur « (# de réplicas - 1) / 2 », arrondi vers le bas.

Propriété Valeur
Valeur par défaut: -1
Valeurs acceptées: -1, 0, 1, 2
--tde-mode

Mode Transparent Data Encryption (TDE) pour cette SQL Managed Instance avec Arc. Valeurs autorisées : ServiceManaged, CustomerManaged ou Disabled. La valeur par défaut est Désactivée.

--tde-protector-private-key-file

Chemin d’accès au fichier contenant une clé privée de certificat au format PEM à utiliser pour TDE.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--tde-protector-public-key-file

Chemin d’accès au fichier contenant une clé publique de certificat au format PEM à utiliser pour TDE.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--tde-protector-secret

Nom du secret Kubernetes qui contient le certificat de protecteur TDE et la clé privée pour cette SQL Managed Instance avec Arc. Ne peut être spécifié que pour le mode TDE CustomerManaged.

--tier -t

Niveau tarifaire de l’instance. Valeurs autorisées : BusinessCritical (bc for short) ou GeneralPurpose (gp for short). La valeur par défaut est GeneralPurpose.

--time-zone

Fuseau horaire SQL Server de l’instance.

--trace-flags

Liste séparée par des virgules de traceflags. Aucun indicateur par défaut.

--use-k8s

Créez une instance managée SQL à l’aide des API Kubernetes locales.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--volume-size-backups

Taille du volume de stockage à utiliser pour les sauvegardes en tant que nombre positif suivi de Ki (kilo-octets), Mi (mégaoctets) ou Gi (gigaoctets).

--volume-size-data

Taille du volume de stockage à utiliser pour les données en tant que nombre positif suivi de Ki (kilo-octets), Mi (mégaoctets) ou Gi (gigaoctets).

--volume-size-datalogs

Taille du volume de stockage à utiliser pour les journaux de données comme nombre positif suivi de Ki (kilo-octets), Mi (mégaoctets) ou Gi (gigaoctets).

--volume-size-logs

Taille du volume de stockage à utiliser pour les journaux comme nombre positif suivi de Ki (kilo-octets), Mi (mégaoctets) ou Gi (gigaoctets).

--volume-size-orchestrator-logs

Taille du volume de stockage à utiliser pour les journaux d’orchestrateur en tant que nombre positif suivi de Ki (kilo-octets), Mi (mégaoctets) ou Gi (gigaoctets).

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az sql mi-arc delete

Supprimez une instance SQL gérée.

az sql mi-arc delete --name
                     [--acquire-policy-token]
                     [--change-reference]
                     [--k8s-namespace]
                     [--no-wait]
                     [--resource-group]
                     [--use-k8s]

Exemples

Supprimez une instance managée SQL via l’API Kubernetes.

az sql mi-arc delete --name sqlmi1 --k8s-namespace arc --use-k8s

Supprimez une instance managée SQL via Azure Resource Manager (ARM).

az sql mi-arc delete --name sqlmi1 --resource-group rg-name

Paramètres obligatoires

--name -n

Nom de l’instance managée SQL à supprimer.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--k8s-namespace -k

Espace de noms dans lequel l’instance managée SQL doit être déployée. Si aucun espace de noms n’est spécifié, l’espace de noms défini dans kubeconfig sera utilisé.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--no-wait

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

Propriété Valeur
Valeur par défaut: False
--resource-group -g

Groupe de ressources Azure dans lequel le SQL Managed Instance avec Arc existe.

Propriété Valeur
Groupe de paramètres: Azure Resource Manager – targeted Arguments
--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az sql mi-arc get-mirroring-cert

Récupérez le certificat du point de terminaison de mise en miroir de groupes de disponibilité à partir de sql mi et stockez-le dans un fichier.

az sql mi-arc get-mirroring-cert --cert-file
                                 --name
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--k8s-namespace]
                                 [--use-k8s]

Exemples

Récupérer le certificat de point de terminaison de mise en miroir de groupes de disponibilité à partir de sqlmi1 et stocker dans filename1

az sql mi-arc get-mirroring-cert -n sqlmi1 --cert-file fileName1

Paramètres obligatoires

--cert-file

Nom de fichier local pour stocker le certificat récupéré au format PEM.

--name -n

Nom de l’instance managée SQL.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--k8s-namespace -k

Espace de noms dans lequel l’instance managée SQL doit être déployée. Si aucun espace de noms n’est spécifié, l’espace de noms défini dans kubeconfig sera utilisé.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az sql mi-arc list

Répertoriez les instances SQL gérées.

az sql mi-arc list [--custom-location]
                   [--k8s-namespace]
                   [--resource-group]
                   [--use-k8s]

Exemples

Répertoriez les instances SQL gérées.

az sql mi-arc list --use-k8s

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--custom-location

Emplacement personnalisé dans lequel les instances managées SQL avec Arc sont déployées. S’il n’est pas spécifié, toutes les instances du groupe de ressources sont répertoriées.

Propriété Valeur
Groupe de paramètres: Azure Resource Manager – targeted Arguments
--k8s-namespace -k

Espace de noms Kubernetes contenant les instances managées SQL avec Arc. Si aucun espace de noms n’est spécifié, l’espace de noms défini dans kubeconfig sera utilisé.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--resource-group -g

Groupe de ressources Azure contenant les instances managées SQL avec Arc.

Propriété Valeur
Groupe de paramètres: Azure Resource Manager – targeted Arguments
--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az sql mi-arc reprovision-replica

Reprovisionnez un réplica dans une instance managée SQL.

az sql mi-arc reprovision-replica --name
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--k8s-namespace]
                                  [--no-wait]
                                  [--use-k8s]

Exemples

Ex 1 - Réavisionner le réplica 1 de SQL Managed Instance sqlmi1.

az sql mi-arc reprovision-replica -n sqlmi1-1 --use-k8s --k8s-namespace namespace

Paramètres obligatoires

--name -n

Nom du réplica d’instance managée SQL à reprovisionner.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--k8s-namespace -k

Espace de noms où le réplica d’instance managée SQL est déployé. Si aucun espace de noms n’est spécifié, l’espace de noms défini dans kubeconfig sera utilisé.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--no-wait

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

Propriété Valeur
Valeur par défaut: False
--use-k8s

Réprovisionner un réplica d’instance managée SQL à l’aide d’API Kubernetes locales.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az sql mi-arc show

Affichez les détails d’une instance SQL gérée.

az sql mi-arc show --name
                   [--k8s-namespace]
                   [--path]
                   [--resource-group]
                   [--use-k8s]

Exemples

Affichez les détails d’un SQL Managed Instance à l’aide de l’API Kubernetes.

az sql mi-arc show --name sqlmi1 --k8s-namespace arc --use-k8s

Affichez les détails d’un SQL Managed Instance en interrogeant Azure Resource Manager (ARM).

az sql mi-arc show --name sqlmi1 --resource-group rg-name

Paramètres obligatoires

--name -n

Nom de l’instance managée SQL à afficher.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--k8s-namespace -k

Espace de noms dans lequel l’instance managée SQL doit être déployée. Si aucun espace de noms n’est spécifié, l’espace de noms défini dans kubeconfig sera utilisé.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--path -p

Chemin d’accès où la spécification complète de l’instance managée SQL doit être écrite. Si elle est omise, la spécification est écrite en sortie standard.

--resource-group -g

Groupe de ressources Azure dans lequel le SQL Managed Instance avec Arc existe.

Propriété Valeur
Groupe de paramètres: Azure Resource Manager – targeted Arguments
--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az sql mi-arc update

Mettez à jour la configuration d’une instance managée SQL.

az sql mi-arc update --name
                     [--acquire-policy-token]
                     [--ad-encryption-types]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--change-reference]
                     [--cores-limit]
                     [--cores-request]
                     [--k8s-namespace]
                     [--keytab-secret]
                     [--labels]
                     [--license-type]
                     [--memory-limit]
                     [--memory-request]
                     [--no-wait]
                     [--orchestrator-replicas]
                     [--path]
                     [--preferred-primary-replica]
                     [--readable-secondaries]
                     [--replicas {1, 2, 3}]
                     [--resource-group]
                     [--retention-days]
                     [--service-annotations]
                     [--service-cert-secret]
                     [--service-labels]
                     [--sync-secondary-to-commit {-1, 0, 1, 2}]
                     [--tde-mode]
                     [--tde-protector-private-key-file]
                     [--tde-protector-public-key-file]
                     [--tde-protector-secret]
                     [--tier]
                     [--time-zone]
                     [--trace-flags]
                     [--use-k8s]

Exemples

Mettez à jour la configuration d’une instance managée SQL.

az sql mi-arc update --path ./spec.json -n sqlmi1 --use-k8s

Paramètres obligatoires

--name -n

Nom de l’instance managée SQL en cours de modification. Le nom sous lequel votre instance est déployée ne peut pas être modifié.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--ad-encryption-types

Liste séparée par des virgules des types de chiffrement pris en charge Active Directory. Doit être un sous-ensemble des valeurs suivantes : RC4, AES128, AES256.

--agent-enabled

Activez SQL Server agent pour l’instance. La valeur par défaut est désactivée.

--annotations

Liste séparée par des virgules des annotations de l’instance managée SQL.

--cert-private-key-file

Chemin d’accès au fichier contenant une clé privée de certificat au format PEM à utiliser pour SQL Server.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--cert-public-key-file

Chemin d’accès au fichier contenant une clé publique de certificat au format PEM à utiliser pour SQL Server.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--cores-limit -c

Limite des cœurs de l’instance managée sous forme d’entier.

--cores-request

Demande de cœurs de l’instance managée sous forme d’entier.

--k8s-namespace -k

Espace de noms dans lequel l’instance managée SQL doit être déployée. Si aucun espace de noms n’est spécifié, l’espace de noms défini dans kubeconfig sera utilisé.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--keytab-secret

Nom du secret Kubernetes qui contient le fichier keytab pour cette SQL Managed Instance avec Arc.

--labels

Liste séparée par des virgules des étiquettes de l’instance managée SQL.

--license-type -l

Le type de licence à appliquer pour ces valeurs autorisées d’instance managée est : BasePrice, LicenseIncluded, DisasterRecovery.Default est LicenseIncluded. Le type de licence peut être modifié..

--memory-limit -m

Limite de la capacité de l’instance managée sous la forme d’un nombre entier suivi de Gio (gigaoctets). Exemple : 4Gi.

--memory-request

Demande de capacité de l’instance managée sous la forme d’un nombre entier suivi de Gio (gigaoctets). Exemple : 4Gi.

--no-wait

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

Propriété Valeur
Valeur par défaut: False
--orchestrator-replicas

Nombre de réplicas d’orchestrateur à haute disponibilité. La valeur doit être comprise entre 1 et 3.

--path

Chemin d’accès au fichier azext_arcdata pour le fichier json de l’instance managée SQL.

--preferred-primary-replica

Réplica principal préféré à mettre à jour.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--readable-secondaries

Nombre de réplicas à rendre lisibles. S’applique uniquement au niveau Critique pour l’entreprise. La valeur doit être comprise entre 0 et le nombre de réplicas moins 1.

--replicas

Cette option spécifie le nombre de réplicas SQL Managed Instance qui seront déployés dans votre cluster Kubernetes à des fins de haute disponibilité.

Propriété Valeur
Valeurs acceptées: 1, 2, 3
--resource-group -g

Groupe de ressources Azure dans lequel le SQL Managed Instance avec Arc existe.

Propriété Valeur
Groupe de paramètres: Azure Resource Manager – targeted Arguments
--retention-days

Période de rétention de sauvegarde, spécifiée en jours. Les valeurs autorisées sont comprises entre 0 et 35. La valeur par défaut est 7. La définition de la période de rétention sur 0 désactive les sauvegardes automatiques pour toutes les bases de données sur l’instance managée SQL et toutes les sauvegardes antérieures seront supprimées.

--service-annotations

Liste séparée par des virgules d’annotations à appliquer à tous les services externes.

--service-cert-secret

Nom du secret Kubernetes pour générer ces hôtes ou hébergera le certificat de service SQL.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--service-labels

Liste séparée par des virgules d’étiquettes à appliquer à tous les services externes.

--sync-secondary-to-commit

Nombre de réplicas secondaires qui doivent être synchronisés pour la validation. Si vous définissez cette valeur sur -1 définissez le nombre de secondaires synchronisés requis sur « (# de réplicas - 1) / 2 », arrondi vers le bas.

Propriété Valeur
Valeurs acceptées: -1, 0, 1, 2
--tde-mode

Mode Transparent Data Encryption (TDE) pour cette SQL Managed Instance avec Arc. Valeurs autorisées : ServiceManaged, CustomerManaged ou Disabled. La valeur par défaut est Désactivée.

--tde-protector-private-key-file

Chemin d’accès au fichier contenant une clé privée de certificat au format PEM à utiliser pour TDE.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--tde-protector-public-key-file

Chemin d’accès au fichier contenant une clé publique de certificat au format PEM à utiliser pour TDE.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--tde-protector-secret

Nom du secret Kubernetes qui contient le certificat de protecteur TDE et la clé privée pour cette SQL Managed Instance avec Arc. Ne peut être spécifié que pour le mode TDE CustomerManaged.

--tier -t

Niveau tarifaire de l’instance. Valeurs autorisées : BusinessCritical (bc for short) ou GeneralPurpose (gp for short). La valeur par défaut est GeneralPurpose.

--time-zone

Fuseau horaire SQL Server de l’instance.

--trace-flags

Liste séparée par des virgules de traceflags. Aucun indicateur par défaut.

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az sql mi-arc upgrade

Mettez à niveau l’instance managée SQL.

Mettez à niveau l’instance managée SQL vers la version souhaitée spécifiée. Si la version souhaitée n’est pas spécifiée, la version du contrôleur de données est utilisée.

az sql mi-arc upgrade [--acquire-policy-token]
                      [--change-reference]
                      [--desired-version]
                      [--dry-run]
                      [--field-filter]
                      [--force]
                      [--k8s-namespace]
                      [--label-filter]
                      [--name]
                      [--no-wait]
                      [--resource-group]
                      [--target]
                      [--use-k8s]

Exemples

Mettez à niveau l’instance managée SQL.

az sql mi-arc upgrade -n sqlmi1 -k arc --desired-version v1.1.0 --use-k8s

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--desired-version -v

Dernière version valide vers la mise à niveau. Facultatif, si aucune version n’est spécifiée, la version du contrôleur de données sera utilisée. Spécifiez « auto » pour effectuer une mise à niveau automatique vers la dernière version valide. En savoir plus sur les mises à niveau automatiques à l’adresse : https://aka.ms/arc-sqlmi-auto-upgrade.

--dry-run -d

Indique quelle instance serait mise à niveau, mais ne met pas réellement à niveau les instances.

--field-filter -f

Filtrez pour sélectionner des instances à mettre à niveau en fonction des propriétés de ressource.

--force

Remplace toutes les stratégies qui peuvent être appliquées à l’instance et tente la mise à niveau.

Propriété Valeur
Valeur par défaut: False
--k8s-namespace -k

Espace de noms dans lequel l’instance managée SQL doit être déployée. Si aucun espace de noms n’est spécifié, l’espace de noms défini dans kubeconfig sera utilisé.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--label-filter -l

Filtrez pour sélectionner l’instance à mettre à niveau en fonction des étiquettes.

--name -n

Nom de l’instance managée SQL.

--no-wait

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

Propriété Valeur
Valeur par défaut: False
--resource-group -g

Groupe de ressources Azure dans lequel le SQL Managed Instance avec Arc cible existe.

Propriété Valeur
Groupe de paramètres: Azure Resource Manager – targeted Arguments
--target
Déprécié

L’option « --target » a été déconseillée et sera supprimée dans une prochaine version. Utilisez plutôt « --desired-version ».

Dernière version valide vers la mise à niveau. Facultatif, si aucune version n’est spécifiée, la version du contrôleur de données sera utilisée. Spécifiez « auto » pour effectuer une mise à niveau automatique vers la dernière version valide. En savoir plus sur les mises à niveau automatiques à l’adresse : https://aka.ms/arc-sqlmi-auto-upgrade.

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False