Partager via


az sql mi-arc

Remarque

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

Gérez les instances SQL Managed Instance avec Azure Arc.

Commandes

Nom Description Type Statut
az sql mi-arc config

Commandes de configuration.

Extension GA
az sql mi-arc config add

Ajoutez une valeur pour un chemin d’accès json dans un fichier de configuration.

Extension GA
az sql mi-arc config init

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

Extension GA
az sql mi-arc config patch

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

Extension GA
az sql mi-arc config remove

Supprimez une valeur pour un chemin d’accès json dans un fichier de configuration.

Extension GA
az sql mi-arc config replace

Remplacez une valeur pour un chemin d’accès json dans un fichier de configuration.

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 edit

Déconseillé, utilisez la mise à jour par rapport à la modification.

Extension Déprécié
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ère le certificat du point de terminaison de mise en miroir de groupe de disponibilité à partir de sql mi et le stocke 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 SQL gérée.

Extension GA
az sql mi-arc upgrade

Mettez à niveau une instance SQL gérée.

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
                     [--ad-account-name]
                     [--ad-connector-name]
                     [--ad-encryption-types]
                     [--admin-login-secret]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--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]
                     [--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 l’authentification Active Directory 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 SQL gérée.

Paramètres facultatifs

--ad-account-name

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

--ad-connector-name

Nom du Connecter or 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 Active Directory pris en charge. Doit être un sous-ensemble des valeurs suivantes : RC4, AES128, AES256.

--admin-login-secret

Nom du secret Kubernetes à générer qui héberge ou hébergera les informations d’identification du compte administrateur.

--agent-enabled

Activez l’agent SQL Server pour l’instance. Par défaut, elle est désactivée. Les valeurs autorisées sont : True ou False.

--annotations

Liste d’étiquettes séparées par des virgules des annotations de l’instance SQL gérée.

--cert-private-key-file

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

--cert-public-key-file

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

--collation

Classement SQL Server pour l’instance.

--cores-limit -c

Limite de cœurs de l’instance gérée sous la forme d’un entier.

--cores-request

Demande de cœurs de l’instance gérée sous la forme d’un entier.

--custom-location

Emplacement personnalisé de cette instance.

--dev

Si elle est spécifiée, elle est considérée comme une instance dev et n’est pas facturée.

--k8s-namespace -k

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

--keytab-secret

Nom du secret Kubernetes qui contient le fichier keytab pour cette instance managée SQL avec Arc.

--labels

Liste d’étiquettes séparées par des virgules de l’instance SQL gérée.

--language

Paramètres régionaux de SQL Server par tout identificateur de langue (LCID) pris en charge pour l’instance.

--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 gérée sous forme d’un nombre entier suivi de Gi (gigaoctets). Exemple : 4Gi.

--memory-request

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

--no-external-endpoint

Si elle est spécifiée, aucun service externe n’est créé. Dans le cas contraire, un service externe est créé en utilisant le même type de service que le contrôleur de données.

--no-wait

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

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 SQL gérée.

--primary-dns-name

Nom DNS du service principal exposé aux utilisateurs finaux pour se connecter à cette instance managée SQL 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).

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

valeurs acceptées: 1, 2, 3
--resource-group -g

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

--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 à cette instance managée SQL 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 d’annotations séparées par des virgules à appliquer à tous les services externes.

--service-cert-secret

Nom du secret Kubernetes à générer qui héberge ou hébergera le certificat de service SQL.

--service-labels

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

--service-type

Type du service principal.

valeurs acceptées: LoadBalancer, NodePort
--storage-annotations

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

--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 données (.mdf, .ndf). Si aucune valeur n’est indiquée, aucune classe de stockage n’est indiquée. Par conséquent, Kubernetes utilisera 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 indiquée, aucune classe de stockage n’est indiquée. Par conséquent, Kubernetes utilisera la classe de stockage par défaut.

--storage-class-logs

Classe de stockage à utiliser pour les journaux (/var/log). Si aucune valeur n’est indiquée, aucune classe de stockage n’est indiquée. Par conséquent, Kubernetes utilisera 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 indiquée, aucune classe de stockage n’est indiquée. Par conséquent, Kubernetes utilisera la classe de stockage par défaut.

--storage-labels

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

--sync-secondary-to-commit

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

valeurs acceptées: -1, 0, 1, 2
valeur par défaut: -1
--tde-mode

Mode TDE (Transparent Data Encryption) pour cette instance managée SQL 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.

--tde-protector-public-key-file

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

--tde-protector-secret

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

--tier -t

Le niveau tarifaire pour cette instance. Valeurs autorisées : BusinessCritical (BC en abrégé) ou GeneralPurpose (GP en abrégé). La valeur par défaut est GeneralPurpose.

--time-zone

Fuseau horaire SQL Server pour l’instance.

--trace-flags

Liste d’indicateurs de trace séparée par des virgules. Aucun indicateur par défaut.

--use-k8s

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

--volume-size-backups

Taille du volume de stockage à utiliser pour les sauvegardes sous la forme d’un 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 sous la forme d’un 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 sous la forme d’un 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 sous la forme d’un 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 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 mi-arc delete

Supprimez une instance SQL gérée.

az sql mi-arc delete --name
                     [--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 SQL gérée à supprimer.

Paramètres facultatifs

--k8s-namespace -k

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

--no-wait

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

valeur par défaut: False
--resource-group -g

Groupe de ressources Azure dans lequel l’instance managée SQL avec Arc existe.

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

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 mi-arc edit

Déprécié

Cette commande a été déconseillée et sera supprimée dans une prochaine version. Utilisez plutôt « update ».

Déconseillé, utilisez la mise à jour par rapport à la modification.

az sql mi-arc edit --name
                   [--agent-enabled]
                   [--annotations]
                   [--cores-limit]
                   [--cores-request]
                   [--custom-location]
                   [--dev]
                   [--k8s-namespace]
                   [--labels]
                   [--license-type]
                   [--location]
                   [--memory-limit]
                   [--memory-request]
                   [--no-wait]
                   [--path]
                   [--resource-group]
                   [--retention-days]
                   [--service-annotations]
                   [--service-labels]
                   [--tag-name]
                   [--tag-value]
                   [--tier]
                   [--time-zone]
                   [--trace-flags]
                   [--use-k8s]

Paramètres obligatoires

--name -n

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

Paramètres facultatifs

--agent-enabled

Activez l’agent SQL Server pour l’instance. Par défaut, elle est désactivée.

--annotations

Liste d’étiquettes séparées par des virgules des annotations de l’instance SQL gérée.

--cores-limit -c

Limite de cœurs de l’instance gérée sous la forme d’un entier.

--cores-request

Demande de cœurs de l’instance gérée sous la forme d’un entier.

--custom-location

Emplacement personnalisé de cette instance.

--dev

Si elle est spécifiée, elle est considérée comme une instance dev et n’est pas facturée.

--k8s-namespace -k

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

--labels

Liste d’étiquettes séparées par des virgules de l’instance SQL gérée.

--license-type

Le type de licence à mettre à jour pour les valeurs autorisées de cette instance managée est : BasePrice, LicenseIncluded, DisasterRecovery. La valeur par défaut est LicenseIncluded.

--location

Emplacement Azure dans lequel les métadonnées sqlmi seront stockées (par exemple, eastus).

--memory-limit -m

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

--memory-request

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

--no-wait

Si elle est spécifiée, la commande n’attend pas que l’instance soit à l’état prêt avant un retour.

valeur par défaut: False
--path

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

--resource-group -g

Groupe de ressources Azure dans lequel l’instance managée SQL avec Arc existe.

--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 d’annotations séparées par des virgules à appliquer à tous les services externes.

--service-labels

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

--tag-name

Nom de balise de l’instance managée SQL.

--tag-value

Valeur de balise de l’instance managée SQL.

--tier -t

Le niveau tarifaire pour cette instance. Valeurs autorisées : BusinessCritical (BC en abrégé) ou GeneralPurpose (GP en abrégé). La valeur par défaut est GeneralPurpose.

--time-zone

Fuseau horaire SQL Server pour l’instance.

--trace-flags

Liste d’indicateurs de trace séparée par des virgules. Aucun indicateur par défaut.

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

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 mi-arc get-mirroring-cert

Récupère le certificat du point de terminaison de mise en miroir de groupe de disponibilité à partir de sql mi et le stocke dans un fichier.

az sql mi-arc get-mirroring-cert --cert-file
                                 --name
                                 [--k8s-namespace]
                                 [--use-k8s]

Exemples

Récupère le certificat du point de terminaison de mise en miroir de groupe de disponibilité à partir de sqlmi1 et le stocke dans le fichier 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 SQL gérée.

Paramètres facultatifs

--k8s-namespace -k

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

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

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

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

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

--resource-group -g

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

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

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 mi-arc reprovision-replica

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

az sql mi-arc reprovision-replica --name
                                  [--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

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

--no-wait

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

valeur par défaut: False
--use-k8s

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

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 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’une instance managée SQL à l’aide de l’API Kubernetes.

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

Affichez les détails d’une instance managée SQL 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 SQL gérée à afficher.

Paramètres facultatifs

--k8s-namespace -k

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

--path -p

Chemin d’accès où l’ensemble de la spécification de l’instance SQL gérée doit être écrit. S’il est omis, la spécification est écrite dans la sortie standard.

--resource-group -g

Groupe de ressources Azure dans lequel l’instance managée SQL avec Arc existe.

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

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 mi-arc update

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

az sql mi-arc update --name
                     [--ad-encryption-types]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--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 SQL gérée.

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

Paramètres obligatoires

--name -n

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

Paramètres facultatifs

--ad-encryption-types

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

--agent-enabled

Activez l’agent SQL Server pour l’instance. Par défaut, elle est désactivée.

--annotations

Liste d’étiquettes séparées par des virgules des annotations de l’instance SQL gérée.

--cert-private-key-file

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

--cert-public-key-file

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

--cores-limit -c

Limite de cœurs de l’instance gérée sous la forme d’un entier.

--cores-request

Demande de cœurs de l’instance gérée sous la forme d’un entier.

--k8s-namespace -k

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

--keytab-secret

Nom du secret Kubernetes qui contient le fichier keytab pour cette instance managée SQL avec Arc.

--labels

Liste d’étiquettes séparées par des virgules de l’instance SQL gérée.

--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 gérée sous forme d’un nombre entier suivi de Gi (gigaoctets). Exemple : 4Gi.

--memory-request

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

--no-wait

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

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 SQL gérée.

--preferred-primary-replica

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

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

valeurs acceptées: 1, 2, 3
--resource-group -g

Groupe de ressources Azure dans lequel l’instance managée SQL avec Arc existe.

--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 d’annotations séparées par des virgules à appliquer à tous les services externes.

--service-cert-secret

Nom du secret Kubernetes à générer qui héberge ou hébergera le certificat de service SQL.

--service-labels

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

--sync-secondary-to-commit

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

valeurs acceptées: -1, 0, 1, 2
--tde-mode

Mode TDE (Transparent Data Encryption) pour cette instance managée SQL 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.

--tde-protector-public-key-file

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

--tde-protector-secret

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

--tier -t

Le niveau tarifaire pour cette instance. Valeurs autorisées : BusinessCritical (BC en abrégé) ou GeneralPurpose (GP en abrégé). La valeur par défaut est GeneralPurpose.

--time-zone

Fuseau horaire SQL Server pour l’instance.

--trace-flags

Liste d’indicateurs de trace séparée par des virgules. Aucun indicateur par défaut.

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

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 mi-arc upgrade

Mettez à niveau une instance SQL gérée.

Mettez à niveau l’instance SQL gérée 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 [--desired-version]
                      [--dry-run]
                      [--field-filter]
                      [--force]
                      [--k8s-namespace]
                      [--label-filter]
                      [--name]
                      [--no-wait]
                      [--resource-group]
                      [--target]
                      [--use-k8s]

Exemples

Mettez à niveau une instance SQL gérée.

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

Paramètres facultatifs

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

valeur par défaut: False
--k8s-namespace -k

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

--label-filter -l

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

--name -n

Nom de l’instance SQL gérée.

--no-wait

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

valeur par défaut: False
--resource-group -g

Groupe de ressources Azure dans lequel existe l’instance managée SQL avec Arc cible.

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

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.