az sql mi-arc

Note

Diese Referenz ist Teil der erweiterung arcdata für die Azure CLI (Version 2.3.1 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az sql mi-arc Befehl ausführen. Erfahren Sie mehr über Erweiterungen.

Verwalten von Azure Arc verwalteten SQL-Instanzen.

Befehle

Name Beschreibung Typ Status
az sql mi-arc config

Konfigurationsbefehle.

 Extension GA
az sql mi-arc config add

Fügen Sie einen Wert für einen JSON-Pfad in einer Konfigurationsdatei hinzu.

 Extension GA
az sql mi-arc config init

Initialisieren Sie die CRD- und Spezifikationsdateien für eine von SQL verwaltete Instanz.

 Extension GA
az sql mi-arc config patch

Patchen Sie eine Konfigurationsdatei basierend auf einer JSON-Patchdatei.

 Extension GA
az sql mi-arc config remove

Entfernen Sie einen Wert für einen JSON-Pfad in einer Konfigurationsdatei.

 Extension GA
az sql mi-arc config replace

Ersetzen Sie einen Wert für einen JSON-Pfad in einer Konfigurationsdatei.

 Extension GA
az sql mi-arc create

Hiermit wird eine verwaltete SQL-Instanz erstellt.

 Extension GA
az sql mi-arc delete

Hiermit wird eine verwaltete SQL-Instanz gelöscht.

 Extension GA
az sql mi-arc endpoint

Anzeigen und Verwalten von SQL-Endpunkten

 Extension GA
az sql mi-arc endpoint list

Damit werden die SQL-Endpunkte aufgelistet.

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

Rufen Sie das Zertifikat des Verfügbarkeitsgruppenspiegelungsendpunkts aus sql mi ab, und speichern Sie es in einer Datei.

 Extension GA
az sql mi-arc list

Hiermit werden verwaltete SQL-Instanzen aufgelistet.

 Extension GA
az sql mi-arc reprovision-replica

Erneutes Bereitstellen eines Replikats in einer sql-verwalteten Instanz.

 Extension GA
az sql mi-arc show

Hiermit werden die Details einer verwalteten SQL-Instanz angezeigt.

 Extension GA
az sql mi-arc update

Aktualisieren sie die Konfiguration einer sql-verwalteten Instanz.

 Extension GA
az sql mi-arc upgrade

Aktualisieren Sie die verwaltete SQL-Instanz.

 Extension GA

az sql mi-arc create

Hiermit wird eine verwaltete SQL-Instanz erstellt.

Um das Kennwort der sql-verwalteten Instanz festzulegen, legen Sie die Umgebungsvariable AZDATA_PASSWORD fest.

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]

Beispiele

Erstellen Sie eine von SQL verwaltete Instanz über die Kubernetes-API.

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

Erstellen Sie eine SQL-verwaltete Instanz mit drei Replikaten in HA-Szenario über die Kubernetes-API.

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

Erstellen einer sql-verwalteten Instanz über Azure Resource Manager (ARM).

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

Erstellen Sie eine von SQL verwaltete Instanz mit Active Directory Authentifizierung über die Kubernetes-API.

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

Erforderliche Parameter

--name -n

Der Name der sql-verwalteten Instanz.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--ad-account-name

Der name des Active Directory Kontos für diese arc-fähige SQL Managed Instance. Dieses Konto muss vor der Bereitstellung dieser Instanz erstellt werden.

--ad-connector-name

Der Name des Active Directory Connectors. Dieser Parameter gibt eine Absicht an, mit AD-Unterstützung bereitzustellen.

--ad-encryption-types

Eine durch Trennzeichen getrennte Liste der unterstützten Active Directory Verschlüsselungstypen. Muss eine Teilmenge der folgenden Werte sein: RC4, AES128, AES256.

--admin-login-secret

Der Name des Kubernetes-Geheimschlüssels, um zu generieren, dass die Anmeldeinformationen des Benutzeradministratorkontos gehostet oder gehostet werden.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--agent-enabled

Aktivieren Sie SQL Server Agent für die Instanz. Die Standardeinstellung ist „Deaktiviert“. Zulässige Werte sind "true" oder "false".

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--annotations

Durch Trennzeichen getrennte Liste der Anmerkungen der verwalteten SQL-Instanz.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--cert-private-key-file

Pfad zur Datei, die einen privaten PEM-Zertifikatschlüssel enthält, der für SQL Server verwendet werden soll.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--cert-public-key-file

Pfad zur Datei, die einen öffentlichen PEM-Zertifikatschlüssel enthält, der für SQL Server verwendet werden soll.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--collation

Die SQL Server Sortierung für die Instanz.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--cores-limit -c

Die Kerne der verwalteten Instanz als ganze Zahl.

--cores-request

Die Anforderung für Kerne der verwalteten Instanz als ganze Zahl.

--custom-location

Der benutzerdefinierte Speicherort für diese Instanz.

Eigenschaft Wert
Parametergruppe: Azure Resource Manager – targeted Arguments
--dev

Wenn dies angegeben ist, wird sie als Dev-Instanz betrachtet und wird nicht in Rechnung gestellt.

--k8s-namespace -k

Namespace, in dem die verwaltete SQL-Instanz bereitgestellt werden soll. Wenn kein Namespace angegeben ist, wird der in der Kubeconfig definierte Namespace verwendet.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--keytab-secret

Der Name des geheimen Kubernetes-Schlüssels, der die Keytabdatei für dieses arc-fähige SQL Managed Instance enthält.

--labels

Durch Trennzeichen getrennte Liste der Bezeichnungen der verwalteten SQL-Instanz.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--language

Das SQL Server Gebietsschema für jede unterstützte Sprach-ID (LCID) für die Instanz.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--license-type -l

Der lizenztyp, der für diese verwaltete Instanz zulässige Werte gilt: BasePrice, LicenseIncluded, DisasterRecovery.Default is LicenseIncluded. Der Lizenztyp kann geändert werden.

--memory-limit -m

Der Grenzwert der Kapazität der verwalteten Instanz als ganze Zahl gefolgt von Gi (Gigabyte). Beispiel: 4Gi.

--memory-request

Die Anforderung für die Kapazität der verwalteten Instanz als ganze Zahl gefolgt von Gi (Gigabyte). Beispiel: 4Gi.

--no-external-endpoint

Wenn angegeben, wird kein externer Dienst erstellt. Andernfalls wird ein externer Dienst mit demselben Diensttyp wie der Datenverantwortliche erstellt.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--orchestrator-replicas

Die Anzahl der Hochverfügbarkeits-Orchestratorreplikate. Der Wert muss zwischen 1 und 3 sein.

--path

Der Pfad zur azext_arcdata Datei für die JSON-Datei der verwalteten SQL-Instanz.

--primary-dns-name

Der primäre Dienst-DNS-Name, der den Endbenutzern zur Verbindung mit diesem arcfähigen SQL Managed Instance (z. B. sqlinstancename.contoso.com) verfügbar gemacht wird.

--primary-port-number

Die Portnummer, auf der der primäre Dienst den Endbenutzern verfügbar gemacht wird (z. B. 31433).

--private-key-file

Private Key File generated by openSSL to use as instance ID.

--readable-secondaries

Anzahl der Replikate, die lesbar gemacht werden sollen. Gilt nur für die Stufe "Geschäftskritisch". Der Wert muss zwischen 0 und der Anzahl der Replikate minus 1 sein.

--replicas

Diese Option gibt die Anzahl der SQL Managed Instance Replikate an, die für hohe Verfügbarkeitszwecke in Ihrem Kubernetes-Cluster bereitgestellt werden. Der Standardwert ist 1 Replikat für allgemeine Zwecke, 3 Replikate für Unternehmenskritisch.

Eigenschaft Wert
Zulässige Werte: 1, 2, 3
--resource-group -g

Die Azure Ressourcengruppe, der die arcfähige SQL Managed Instance hinzugefügt werden soll.

Eigenschaft Wert
Parametergruppe: Azure Resource Manager – targeted Arguments
--retention-days

Sicherungsaufbewahrungszeitraum, der in Tagen angegeben ist. Zulässige Werte sind 0 bis 35. Der Standardwert ist 7. Wenn Sie den Aufbewahrungszeitraum auf 0 festlegen, werden automatische Sicherungen für alle Datenbanken in der verwalteten SQL-Instanz deaktiviert, und alle vorherigen Sicherungen werden gelöscht.

--secondary-dns-name

Der sekundäre Dienst-DNS-Name, der den Endbenutzern zur Verbindung mit diesem arcfähigen SQL Managed Instance (z. B. sqlinstancename2.contoso.com) verfügbar gemacht wird.

--secondary-port-number

Die Portnummer, auf der der sekundäre Dienst den Endbenutzern verfügbar gemacht wird (z. B. 31434).

--service-annotations

Durch Trennzeichen getrennte Liste von Anmerkungen, die für alle externen Dienste gelten sollen.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--service-cert-secret

Name des Kubernetes-Schlüssels zum Generieren dieses Hosts oder Hosten des SQL-Dienstzertifikats.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--service-labels

Durch Trennzeichen getrennte Liste der Bezeichnungen, die auf alle externen Dienste angewendet werden sollen.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--service-type

Der Typ für den primären Dienst.

Eigenschaft Wert
Zulässige Werte: LoadBalancer, NodePort
--storage-annotations

Durch Trennzeichen getrennte Liste von Anmerkungen, die auf alle PVCs angewendet werden sollen.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--storage-class-backups

Eine ReadWriteMany (RWX)-fähige Speicherklasse, die für Sicherungen verwendet werden kann (/var/opt/mssql/backups). Wenn kein Wert angegeben ist, wird die Standardspeicherklasse verwendet.

--storage-class-data -d

Die Speicherklasse, die für Datendateien verwendet werden soll (.mdf, ndf). Wenn kein Wert angegeben wird, wird keine Speicherklasse angegeben, was zu Kubernetes mit der Standardspeicherklasse führt.

--storage-class-datalogs

Die Speicherklasse, die für Datenbankprotokolle (LDF) verwendet werden soll. Wenn kein Wert angegeben wird, wird keine Speicherklasse angegeben, was zu Kubernetes mit der Standardspeicherklasse führt.

--storage-class-logs

Die Speicherklasse, die für Protokolle (/var/log) verwendet werden soll. Wenn kein Wert angegeben wird, wird keine Speicherklasse angegeben, was zu Kubernetes mit der Standardspeicherklasse führt.

--storage-class-orchestrator-logs

Die Speicherklasse, die für Orchestratorprotokolle (/var/log) verwendet werden soll. Wenn kein Wert angegeben wird, wird keine Speicherklasse angegeben, was zu Kubernetes mit der Standardspeicherklasse führt.

--storage-labels

Durch Trennzeichen getrennte Liste der Etiketten, die auf alle PVCs angewendet werden sollen.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--sync-secondary-to-commit

Anzahl der sekundären Replikate, die zum Commit synchronisiert werden müssen. Wenn Sie diesen Wert auf -1 festlegen, wird die Anzahl der erforderlichen synchronisierten Secondärdateien auf "(Anzahl der Replikate - 1) / 2" festgelegt, aufgerundet.

Eigenschaft Wert
Standardwert: -1
Zulässige Werte: -1, 0, 1, 2
--tde-mode

Der Transparent Data Encryption -Modus (TDE) für dieses arc-fähige SQL Managed Instance. Zulässige Werte: ServiceManaged, CustomerManaged oder Disabled. Der Standardwert ist deaktiviert.

--tde-protector-private-key-file

Pfad zur Datei, die einen privaten PEM-Zertifikatschlüssel enthält, der für TDE verwendet werden soll.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--tde-protector-public-key-file

Pfad zur Datei, die einen öffentlichen PEM-Zertifikatschlüssel enthält, der für TDE verwendet werden soll.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--tde-protector-secret

Der Name des Kubernetes-Schlüssels, der das TDE-Schutzzertifikat und den privaten Schlüssel für diesen arcfähigen SQL Managed Instance enthält. Kann nur für den CustomerManaged TDE-Modus angegeben werden.

--tier -t

Das Preisniveau für die Instanz. Zulässige Werte: BusinessCritical (bc für kurz) oder GeneralPurpose (gp für kurze Zeit). Der Standardwert ist "GeneralPurpose".

--time-zone

Die Zeitzone SQL Server für die Instanz.

--trace-flags

Durch Trennzeichen getrennte Liste von Traceflags. Standardmäßig sind keine Kennzeichnungen vorhanden.

--use-k8s

Erstellen Sie sql managed instance using local Kubernetes APIs.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--volume-size-backups

Die Größe des Speichervolumes, das für Sicherungen als positive Zahl verwendet werden soll, gefolgt von Ki (Kilobyte), Mi (Megabyte) oder Gi (Gigabyte).

--volume-size-data

Die Größe des Speichervolumens, das für Daten als positive Zahl verwendet werden soll, gefolgt von Ki (Kilobyte), Mi (Megabyte) oder Gi (Gigabyte).

--volume-size-datalogs

Die Größe des Speichervolumens, das für Datenprotokolle als positive Zahl verwendet werden soll, gefolgt von Ki (Kilobyte), Mi (Megabyte) oder Gi (Gigabyte).

--volume-size-logs

Die Größe des Speichervolumens, das für Protokolle als positive Zahl verwendet werden soll, gefolgt von Ki (Kilobyte), Mi (Megabyte) oder Gi (Gigabyte).

--volume-size-orchestrator-logs

Die Größe des Speichervolumes, das für Orchestratorprotokolle verwendet werden soll, als positive Zahl gefolgt von Ki (Kilobyte), Mi (Megabyte) oder Gi (Gigabyte).

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az sql mi-arc delete

Hiermit wird eine verwaltete SQL-Instanz gelöscht.

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

Beispiele

Löschen Sie eine von SQL verwaltete Instanz über die Kubernetes-API.

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

Löschen einer SQL-verwalteten Instanz über Azure Resource Manager (ARM).

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

Erforderliche Parameter

--name -n

Der Name der sql-verwalteten Instanz, die gelöscht werden soll.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--k8s-namespace -k

Namespace, in dem die verwaltete SQL-Instanz bereitgestellt werden soll. Wenn kein Namespace angegeben ist, wird der in der Kubeconfig definierte Namespace verwendet.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--resource-group -g

Die Azure Ressourcengruppe, in der die arcfähige SQL Managed Instance vorhanden ist.

Eigenschaft Wert
Parametergruppe: Azure Resource Manager – targeted Arguments
--use-k8s

Verwenden Sie lokale Kubernetes-APIs, um diese Aktion auszuführen.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az sql mi-arc get-mirroring-cert

Rufen Sie das Zertifikat des Verfügbarkeitsgruppenspiegelungsendpunkts aus sql mi ab, und speichern Sie es in einer Datei.

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

Beispiele

Abrufen des Zertifikats für den Spiegelungsendpunkt der Verfügbarkeitsgruppe aus sqlmi1 und Speichern in Dateidateiname1

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

Erforderliche Parameter

--cert-file

Der lokale Dateiname zum Speichern des abgerufenen Zertifikats im PEM-Format.

--name -n

Der Name der sql-verwalteten Instanz.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--k8s-namespace -k

Namespace, in dem die verwaltete SQL-Instanz bereitgestellt werden soll. Wenn kein Namespace angegeben ist, wird der in der Kubeconfig definierte Namespace verwendet.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--use-k8s

Verwenden Sie lokale Kubernetes-APIs, um diese Aktion auszuführen.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az sql mi-arc list

Hiermit werden verwaltete SQL-Instanzen aufgelistet.

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

Beispiele

Hiermit werden verwaltete SQL-Instanzen aufgelistet.

az sql mi-arc list --use-k8s

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--custom-location

Der benutzerdefinierte Speicherort, an dem die arcfähigen verwalteten SQL-Instanzen bereitgestellt werden. Wenn nicht angegeben, werden alle Instanzen in der Ressourcengruppe aufgelistet.

Eigenschaft Wert
Parametergruppe: Azure Resource Manager – targeted Arguments
--k8s-namespace -k

Der Kubernetes-Namespace, der die arcfähigen verwalteten SQL-Instanzen enthält. Wenn kein Namespace angegeben ist, wird der in der Kubeconfig definierte Namespace verwendet.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--resource-group -g

Die Azure-Ressourcengruppe, die die arcfähigen verwalteten SQL-Instanzen enthält.

Eigenschaft Wert
Parametergruppe: Azure Resource Manager – targeted Arguments
--use-k8s

Verwenden Sie lokale Kubernetes-APIs, um diese Aktion auszuführen.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az sql mi-arc reprovision-replica

Erneutes Bereitstellen eines Replikats in einer sql-verwalteten Instanz.

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

Beispiele

Ex 1 – Reprovision Replica 1 von SQL managed instance sqlmi1.

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

Erforderliche Parameter

--name -n

Der Name des sql-verwalteten Instanzreplikats, das neu bereitgestellt werden soll.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--k8s-namespace -k

Namespace, in dem das sql-verwaltete Instanzreplikat bereitgestellt wird. Wenn kein Namespace angegeben ist, wird der in der Kubeconfig definierte Namespace verwendet.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--use-k8s

Erneutes Bereitstellen des sql-verwalteten Instanzreplikats mithilfe lokaler Kubernetes-APIs.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az sql mi-arc show

Hiermit werden die Details einer verwalteten SQL-Instanz angezeigt.

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

Beispiele

Zeigen Sie die Details einer SQL Managed Instance mithilfe der Kubernetes-API an.

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

Zeigen Sie die Details eines SQL Managed Instance an, indem Sie Azure Resource Manager (ARM) abfragen.

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

Erforderliche Parameter

--name -n

Der Name der sql-verwalteten Instanz, die angezeigt werden soll.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--k8s-namespace -k

Namespace, in dem die verwaltete SQL-Instanz bereitgestellt werden soll. Wenn kein Namespace angegeben ist, wird der in der Kubeconfig definierte Namespace verwendet.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--path -p

Ein Pfad, in dem die vollständige Spezifikation für die verwaltete SQL-Instanz geschrieben werden soll. Wenn diese Angabe weggelassen wird, wird die Spezifikation in die Standardausgabe geschrieben.

--resource-group -g

Die Azure Ressourcengruppe, in der die arcfähige SQL Managed Instance vorhanden ist.

Eigenschaft Wert
Parametergruppe: Azure Resource Manager – targeted Arguments
--use-k8s

Verwenden Sie lokale Kubernetes-APIs, um diese Aktion auszuführen.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az sql mi-arc update

Aktualisieren sie die Konfiguration einer sql-verwalteten Instanz.

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]

Beispiele

Aktualisieren sie die Konfiguration einer sql-verwalteten Instanz.

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

Erforderliche Parameter

--name -n

Der Name der sql-verwalteten Instanz, die bearbeitet wird. Der Name, unter dem Ihre Instanz bereitgestellt wird, kann nicht geändert werden.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--ad-encryption-types

Eine durch Trennzeichen getrennte Liste der unterstützten Active Directory Verschlüsselungstypen. Muss eine Teilmenge der folgenden Werte sein: RC4, AES128, AES256.

--agent-enabled

Aktivieren Sie SQL Server Agent für die Instanz. Die Standardeinstellung ist „Deaktiviert“.

--annotations

Durch Trennzeichen getrennte Liste der Anmerkungen der verwalteten SQL-Instanz.

--cert-private-key-file

Pfad zur Datei, die einen privaten PEM-Zertifikatschlüssel enthält, der für SQL Server verwendet werden soll.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--cert-public-key-file

Pfad zur Datei, die einen öffentlichen PEM-Zertifikatschlüssel enthält, der für SQL Server verwendet werden soll.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--cores-limit -c

Die Kerne der verwalteten Instanz als ganze Zahl.

--cores-request

Die Anforderung für Kerne der verwalteten Instanz als ganze Zahl.

--k8s-namespace -k

Namespace, in dem die verwaltete SQL-Instanz bereitgestellt werden soll. Wenn kein Namespace angegeben ist, wird der in der Kubeconfig definierte Namespace verwendet.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--keytab-secret

Der Name des geheimen Kubernetes-Schlüssels, der die Keytabdatei für dieses arc-fähige SQL Managed Instance enthält.

--labels

Durch Trennzeichen getrennte Liste der Bezeichnungen der verwalteten SQL-Instanz.

--license-type -l

Der lizenztyp, der für diese verwaltete Instanz zulässige Werte gilt: BasePrice, LicenseIncluded, DisasterRecovery.Default is LicenseIncluded. Der Lizenztyp kann geändert werden.

--memory-limit -m

Der Grenzwert der Kapazität der verwalteten Instanz als ganze Zahl gefolgt von Gi (Gigabyte). Beispiel: 4Gi.

--memory-request

Die Anforderung für die Kapazität der verwalteten Instanz als ganze Zahl gefolgt von Gi (Gigabyte). Beispiel: 4Gi.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--orchestrator-replicas

Die Anzahl der Hochverfügbarkeits-Orchestratorreplikate. Der Wert muss zwischen 1 und 3 sein.

--path

Der Pfad zur azext_arcdata Datei für die JSON-Datei der verwalteten SQL-Instanz.

--preferred-primary-replica

Das bevorzugte primäre Replikat, das aktualisiert werden soll.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--readable-secondaries

Anzahl der Replikate, die lesbar gemacht werden sollen. Gilt nur für die Stufe "Geschäftskritisch". Der Wert muss zwischen 0 und der Anzahl der Replikate minus 1 sein.

--replicas

Diese Option gibt die Anzahl der SQL Managed Instance Replikate an, die für hohe Verfügbarkeitszwecke in Ihrem Kubernetes-Cluster bereitgestellt werden.

Eigenschaft Wert
Zulässige Werte: 1, 2, 3
--resource-group -g

Die Azure Ressourcengruppe, in der die arcfähige SQL Managed Instance vorhanden ist.

Eigenschaft Wert
Parametergruppe: Azure Resource Manager – targeted Arguments
--retention-days

Sicherungsaufbewahrungszeitraum, der in Tagen angegeben ist. Zulässige Werte sind 0 bis 35. Der Standardwert ist 7. Wenn Sie den Aufbewahrungszeitraum auf 0 festlegen, werden automatische Sicherungen für alle Datenbanken in der verwalteten SQL-Instanz deaktiviert, und alle vorherigen Sicherungen werden gelöscht.

--service-annotations

Durch Trennzeichen getrennte Liste von Anmerkungen, die für alle externen Dienste gelten sollen.

--service-cert-secret

Name des Kubernetes-Schlüssels zum Generieren dieses Hosts oder Hosten des SQL-Dienstzertifikats.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--service-labels

Durch Trennzeichen getrennte Liste der Bezeichnungen, die auf alle externen Dienste angewendet werden sollen.

--sync-secondary-to-commit

Anzahl der sekundären Replikate, die zum Commit synchronisiert werden müssen. Wenn Sie diesen Wert auf -1 festlegen, wird die Anzahl der erforderlichen synchronisierten Secondärdateien auf "(Anzahl der Replikate - 1) / 2" festgelegt, aufgerundet.

Eigenschaft Wert
Zulässige Werte: -1, 0, 1, 2
--tde-mode

Der Transparent Data Encryption -Modus (TDE) für dieses arc-fähige SQL Managed Instance. Zulässige Werte: ServiceManaged, CustomerManaged oder Disabled. Der Standardwert ist deaktiviert.

--tde-protector-private-key-file

Pfad zur Datei, die einen privaten PEM-Zertifikatschlüssel enthält, der für TDE verwendet werden soll.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--tde-protector-public-key-file

Pfad zur Datei, die einen öffentlichen PEM-Zertifikatschlüssel enthält, der für TDE verwendet werden soll.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--tde-protector-secret

Der Name des Kubernetes-Schlüssels, der das TDE-Schutzzertifikat und den privaten Schlüssel für diesen arcfähigen SQL Managed Instance enthält. Kann nur für den CustomerManaged TDE-Modus angegeben werden.

--tier -t

Das Preisniveau für die Instanz. Zulässige Werte: BusinessCritical (bc für kurz) oder GeneralPurpose (gp für kurze Zeit). Der Standardwert ist "GeneralPurpose".

--time-zone

Die Zeitzone SQL Server für die Instanz.

--trace-flags

Durch Trennzeichen getrennte Liste von Traceflags. Standardmäßig sind keine Kennzeichnungen vorhanden.

--use-k8s

Verwenden Sie lokale Kubernetes-APIs, um diese Aktion auszuführen.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az sql mi-arc upgrade

Aktualisieren Sie die verwaltete SQL-Instanz.

Aktualisieren Sie die verwaltete SQL-Instanz auf die angegebene gewünschte Version. Wenn die gewünschte Version nicht angegeben ist, wird die Datenverantwortliche-Version verwendet.

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]

Beispiele

Aktualisieren Sie die verwaltete SQL-Instanz.

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--desired-version -v

Die neueste gültige Version, auf die ein Upgrade durchgeführt werden soll. Optional, wenn keine Version angegeben ist, wird die Datenverantwortliche-Version verwendet. Geben Sie "auto" an, um automatisch auf die neueste gültige Version zu aktualisieren. Weitere Informationen zu automatischen Upgrades finden Sie unter: https://aka.ms/arc-sqlmi-auto-upgrade.

--dry-run -d

Gibt an, welche Instanz aktualisiert werden würde, aber nicht tatsächlich die Instanzen aktualisiert.

--field-filter -f

Filtern, um Instanzen auszuwählen, die basierend auf Ressourceneigenschaften aktualisiert werden sollen.

--force

Überschreibt alle Richtlinien, die auf die Instanz angewendet werden können, und versucht das Upgrade.

Eigenschaft Wert
Standardwert: False
--k8s-namespace -k

Namespace, in dem die verwaltete SQL-Instanz bereitgestellt werden soll. Wenn kein Namespace angegeben ist, wird der in der Kubeconfig definierte Namespace verwendet.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
--label-filter -l

Filtern, um die Instanz auszuwählen, die auf Bezeichnungen basiert.

--name -n

Der Name der sql-verwalteten Instanz.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--resource-group -g

Die Azure Ressourcengruppe, in der die arcfähige Ziel-SQL Managed Instance vorhanden ist.

Eigenschaft Wert
Parametergruppe: Azure Resource Manager – targeted Arguments
--target
Als veraltet markiert

Option "--target" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "---desired-version".

Die neueste gültige Version, auf die ein Upgrade durchgeführt werden soll. Optional, wenn keine Version angegeben ist, wird die Datenverantwortliche-Version verwendet. Geben Sie "auto" an, um automatisch auf die neueste gültige Version zu aktualisieren. Weitere Informationen zu automatischen Upgrades finden Sie unter: https://aka.ms/arc-sqlmi-auto-upgrade.

--use-k8s

Verwenden Sie lokale Kubernetes-APIs, um diese Aktion auszuführen.

Eigenschaft Wert
Parametergruppe: Kubernetes API – targeted Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False