Share via


az sql mi-arc

Hinweis

Diese Referenz ist Teil der Arcdata-Erweiterung 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 zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten von Azure Arc-fähigen SQL Managed Instance-Instanzen.

Befehle

Name Beschreibung Typ Status
az sql mi-arc config

Konfigurationsbefehle

Durchwahl Allgemein verfügbar
az sql mi-arc config add

Fügt einen Wert in einem JSON-Pfad in einer Konfigurationsdatei hinzu.

Durchwahl Allgemein verfügbar
az sql mi-arc config init

Hiermit werden die CRD-Datei und die Spezifikationsdatei für eine verwaltete SQL-Instanz initialisiert.

Durchwahl Allgemein verfügbar
az sql mi-arc config patch

Patcht eine Konfigurationsdatei auf Grundlage einer JSON-Patchdatei

Durchwahl Allgemein verfügbar
az sql mi-arc config remove

Entfernt einen Wert in einem JSON-Pfad in einer Konfigurationsdatei.

Durchwahl Allgemein verfügbar
az sql mi-arc config replace

Ersetzt einen Wert in einem JSON-Pfad in einer Konfigurationsdatei.

Durchwahl Allgemein verfügbar
az sql mi-arc create

Hiermit wird eine verwaltete SQL-Instanz erstellt.

Durchwahl Allgemein verfügbar
az sql mi-arc delete

Hiermit wird eine verwaltete SQL-Instanz gelöscht.

Durchwahl Allgemein verfügbar
az sql mi-arc edit

Veraltet, Aktualisierung über Bearbeitung verwenden.

Durchwahl Als veraltet markiert
az sql mi-arc endpoint

Anzeigen und Verwalten von SQL-Endpunkten

Durchwahl Allgemein verfügbar
az sql mi-arc endpoint list

Damit werden die SQL-Endpunkte aufgelistet.

Durchwahl Allgemein verfügbar
az sql mi-arc get-mirroring-cert

Ruft das Zertifikat des Spiegelungsendpunkts der Verfügbarkeitsgruppe von sqlmi ab, und speichert es in einer Datei.

Durchwahl Allgemein verfügbar
az sql mi-arc list

Hiermit werden verwaltete SQL-Instanzen aufgelistet.

Durchwahl Allgemein verfügbar
az sql mi-arc reprovision-replica

Erneutes Bereitstellen eines Replikats in einer sql-verwalteten Instanz.

Durchwahl Allgemein verfügbar
az sql mi-arc show

Hiermit werden die Details einer verwalteten SQL-Instanz angezeigt.

Durchwahl Allgemein verfügbar
az sql mi-arc update

Hiermit wird die Konfiguration einer verwalteten SQL-Instanz aktualisiert.

Durchwahl Allgemein verfügbar
az sql mi-arc upgrade

Hiermit wird eine verwaltete SQL-Instanz geupgradet.

Durchwahl Allgemein verfügbar

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

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 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 verwalteten SQL-Instanz.

Optionale Parameter

--ad-account-name

Der Name des Active Directory-Kontos für diese arc-aktivierte SQL-verwaltete Instanz. Dieses Konto muss vor der Bereitstellung dieser Instanz erstellt werden.

--ad-connector-name

Der Name des Active Directory-Verbinden or. 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

Name des zu generierenden Kubernetes-Geheimnisses, das die Anmeldeinformationen der Administratoranmeldung des Hostbenutzers hostet oder hosten wird.

--agent-enabled

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

--annotations

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

--cert-private-key-file

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

--cert-public-key-file

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

--collation

Die SQL-Serversortierung für die Instanz.

--cores-limit -c

Das Limit für Kerne der verwalteten Instanz als Integer.

--cores-request

Die Anforderung für Kerne der verwalteten Instanz als Integer.

--custom-location

Der benutzerdefinierte Speicherort für diese Instanz.

--dev

Wenn dieser Wert angegeben wird, gilt die Instanz als Entwicklungsinstanz, und es fallen keine Kosten dafür an.

--k8s-namespace -k

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

--keytab-secret

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

--labels

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

--language

Das SQL Server-Gebietsschema zum jeweiligen unterstützten Gebietsschemabezeichner (LCID) für die 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

Das Limit für die Kapazität der verwalteten Instanz als ganze Zahl (integer), gefolgt von „Gi“ (GB). Beispiel: 4Gi.

--memory-request

Die Anforderung der Kapazität der verwalteten Instanz als ganze Zahl (integer), gefolgt von „Gi“ (GB). Beispiel: 4Gi.

--no-external-endpoint

Falls ein Wert angegeben ist, wird kein externer Dienst erstellt. Andernfalls wird ein externer Dienst mit demselben Diensttyp wie dem des Datencontrollers erstellt.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

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 name des primären Diensts, der den Endbenutzern zur Verbindung mit dieser arcfähigen SQL-verwaltete Instanz (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).

--readable-secondaries

Anzahl der Replikate, die lesbar gemacht werden sollen. Gilt nur für Unternehmenskritisch Ebene. Der Wert muss zwischen 0 und der Anzahl der Replikate minus 1 sein.

--replicas

Diese Option gibt die Anzahl der SQL-verwaltete Instanz-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.

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

Die Azure-Ressourcengruppe, der die arcfähige SQL-verwaltete Instanz hinzugefügt werden soll.

--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-verwaltete Instanz (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 auf alle externen Dienste angewendet werden sollen.

--service-cert-secret

Name des zu generierenden Kubernetes-Geheimnisses, das das SQL-Dienstzertifikat hostet oder hosten wird.

--service-labels

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

--service-type

Der Typ für den primären Dienst.

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

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

--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 für Datendateien zu verwendende Speicherklasse (.mdf, .ndf). Wenn kein Wert angegeben wird, wird keine Speicherklasse angegeben, was dazu führt, dass Kubernetes die Standardspeicherklasse nutzt.

--storage-class-datalogs

Die für Datenbankprotokolle zu verwendende Speicherklasse (.ldf). Wenn kein Wert angegeben wird, wird keine Speicherklasse angegeben, was dazu führt, dass Kubernetes die Standardspeicherklasse nutzt.

--storage-class-logs

Die für Protokolle zu verwendende Speicherklasse (/var/log). Wenn kein Wert angegeben wird, wird keine Speicherklasse angegeben, was dazu führt, dass Kubernetes die Standardspeicherklasse nutzt.

--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 dazu führt, dass Kubernetes die Standardspeicherklasse nutzt.

--storage-labels

Durch Trennzeichen getrennte Liste von Bezeichnungen, die auf alle PVCs 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 "(# der Replikate - 1) / 2" festgelegt, aufgerundet.

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

Der TDE-Modus (Transparent Data Encryption) für dieses arc-fähige SQL-verwaltete Instanz. 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.

--tde-protector-public-key-file

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

--tde-protector-secret

Der Name des Kubernetes-Schlüssels, der das TDE-Schutzzertifikat und den privaten Schlüssel für diese arc-fähige SQL-verwaltete Instanz enthält. Kann nur für den CustomerManaged TDE-Modus angegeben werden.

--tier -t

Der Tarif für die Instanz. Zulässige Werte: „BusinessCritical“ (Kurzform: bc) oder „GeneralPurpose“ (Kurzform: gp). Der Standardwert ist „GeneralPurpose“.

--time-zone

Die SQL Server-Zeitzone für die Instanz.

--trace-flags

Durch Trennzeichen getrennte Liste von Ablaufverfolgungsflags. Standardeinstellung ist ohne Flags.

--use-k8s

Erstellen einer verwalteten SQL-Instanz mithilfe von lokalen Kubernetes-APIs.

--volume-size-backups

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

--volume-size-data

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

--volume-size-datalogs

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

--volume-size-logs

Dies ist die Größe des Speichervolumes, das für Datenprotokolle verwendet werden soll, als positive Zahl, 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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sql mi-arc delete

Hiermit wird eine verwaltete SQL-Instanz gelöscht.

az sql mi-arc delete --name
                     [--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 verwalteten SQL-Instanz, die gelöscht werden soll.

Optionale Parameter

--k8s-namespace -k

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

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--resource-group -g

Die Azure-Ressourcengruppe, in der die arcfähige SQL-verwaltete Instanz vorhanden ist.

--use-k8s

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sql mi-arc edit

Als veraltet markiert

Dieser Befehl ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "Update".

Veraltet, Aktualisierung über Bearbeitung verwenden.

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]

Erforderliche Parameter

--name -n

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

Optionale Parameter

--agent-enabled

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

--annotations

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

--cores-limit -c

Das Limit für Kerne der verwalteten Instanz als Integer.

--cores-request

Die Anforderung für Kerne der verwalteten Instanz als Integer.

--custom-location

Der benutzerdefinierte Speicherort für diese Instanz.

--dev

Wenn dieser Wert angegeben wird, gilt die Instanz als Entwicklungsinstanz, und es fallen keine Kosten dafür an.

--k8s-namespace -k

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

--labels

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

--license-type

Der Lizenztyp, der für diese verwaltete Instanz aktualisiert werden soll, sind zulässige Werte: BasePrice, LicenseIncluded, DisasterRecovery. Der Standardwert ist „LicenseIncluded“.

--location

Der Azure-Speicherort, an dem die SQLMI-Metadaten gespeichert werden (z. B. Ost).

--memory-limit -m

Das Limit für die Kapazität der verwalteten Instanz als ganze Zahl (integer), gefolgt von „Gi“ (GB). Beispiel: 4Gi.

--memory-request

Die Anforderung der Kapazität der verwalteten Instanz als ganze Zahl (integer), gefolgt von „Gi“ (GB). Beispiel: 4Gi.

--no-wait

Wenn dieser Wert vorhanden ist, wartet der Befehl nicht darauf, dass die Instanz bereit ist, bis eine Rückgabe erfolgt.

Standardwert: False
--path

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

--resource-group -g

Die Azure-Ressourcengruppe, in der die arcfähige SQL-verwaltete Instanz vorhanden ist.

--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 auf alle externen Dienste angewendet werden sollen.

--service-labels

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

--tag-name

Der Tagname der sql-verwalteten Instanz.

--tag-value

Der Tagwert der verwalteten SQL-Instanz.

--tier -t

Der Tarif für die Instanz. Zulässige Werte: „BusinessCritical“ (Kurzform: bc) oder „GeneralPurpose“ (Kurzform: gp). Der Standardwert ist „GeneralPurpose“.

--time-zone

Die SQL Server-Zeitzone für die Instanz.

--trace-flags

Durch Trennzeichen getrennte Liste von Ablaufverfolgungsflags. Standardeinstellung ist ohne Flags.

--use-k8s

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sql mi-arc get-mirroring-cert

Ruft das Zertifikat des Spiegelungsendpunkts der Verfügbarkeitsgruppe von sqlmi ab, und speichert es in einer Datei.

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

Beispiele

Ruft das Zertifikat des Spiegelungsendpunkts der Verfügbarkeitsgruppe von sqlmi1 ab, und speichert es in der Datei „fileName1“.

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 verwalteten SQL-Instanz.

Optionale Parameter

--k8s-namespace -k

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

--use-k8s

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

--custom-location

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

--k8s-namespace -k

Der Kubernetes-Namespace, der die arcfähigen SQL-verwaltete Instanz s enthält. Wenn kein Namespace angegeben ist, wird der in kubeconfig definierte Namespace verwendet.

--resource-group -g

Die Azure-Ressourcengruppe mit den arcfähigen SQL-verwaltete Instanz s.

--use-k8s

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sql mi-arc reprovision-replica

Erneutes Bereitstellen eines Replikats in einer sql-verwalteten Instanz.

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

--k8s-namespace -k

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

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--use-k8s

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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 eines SQL-verwaltete Instanz mithilfe der Kubernetes-API an.

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

Zeigen Sie die Details einer SQL-verwaltete Instanz 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 verwalteten SQL-Instanz, die angezeigt werden soll.

Optionale Parameter

--k8s-namespace -k

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

--path -p

Ein Pfad, unter den die vollständige Spezifikation der verwalteten SQL-Instanz geschrieben werden soll. Wenn keine Angabe erfolgt, wird die Spezifikation in die Standardausgabe geschrieben.

--resource-group -g

Die Azure-Ressourcengruppe, in der die arcfähige SQL-verwaltete Instanz vorhanden ist.

--use-k8s

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sql mi-arc update

Hiermit wird die Konfiguration einer verwalteten SQL-Instanz aktualisiert.

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]

Beispiele

Hiermit wird die Konfiguration einer verwalteten SQL-Instanz aktualisiert.

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

Erforderliche Parameter

--name -n

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

Optionale Parameter

--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 den SQL Server-Agent für die Instanz. Die Standardeinstellung ist „Deaktiviert“.

--annotations

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

--cert-private-key-file

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

--cert-public-key-file

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

--cores-limit -c

Das Limit für Kerne der verwalteten Instanz als Integer.

--cores-request

Die Anforderung für Kerne der verwalteten Instanz als Integer.

--k8s-namespace -k

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

--keytab-secret

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

--labels

Durch Trennzeichen getrennte Liste von 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

Das Limit für die Kapazität der verwalteten Instanz als ganze Zahl (integer), gefolgt von „Gi“ (GB). Beispiel: 4Gi.

--memory-request

Die Anforderung der Kapazität der verwalteten Instanz als ganze Zahl (integer), gefolgt von „Gi“ (GB). Beispiel: 4Gi.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

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.

--readable-secondaries

Anzahl der Replikate, die lesbar gemacht werden sollen. Gilt nur für Unternehmenskritisch Ebene. Der Wert muss zwischen 0 und der Anzahl der Replikate minus 1 sein.

--replicas

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

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

Die Azure-Ressourcengruppe, in der die arcfähige SQL-verwaltete Instanz vorhanden ist.

--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 auf alle externen Dienste angewendet werden sollen.

--service-cert-secret

Name des zu generierenden Kubernetes-Geheimnisses, das das SQL-Dienstzertifikat hostet oder hosten wird.

--service-labels

Durch Trennzeichen getrennte Liste von 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 "(# der Replikate - 1) / 2" festgelegt, aufgerundet.

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

Der TDE-Modus (Transparent Data Encryption) für dieses arc-fähige SQL-verwaltete Instanz. 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.

--tde-protector-public-key-file

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

--tde-protector-secret

Der Name des Kubernetes-Schlüssels, der das TDE-Schutzzertifikat und den privaten Schlüssel für diese arc-fähige SQL-verwaltete Instanz enthält. Kann nur für den CustomerManaged TDE-Modus angegeben werden.

--tier -t

Der Tarif für die Instanz. Zulässige Werte: „BusinessCritical“ (Kurzform: bc) oder „GeneralPurpose“ (Kurzform: gp). Der Standardwert ist „GeneralPurpose“.

--time-zone

Die SQL Server-Zeitzone für die Instanz.

--trace-flags

Durch Trennzeichen getrennte Liste von Ablaufverfolgungsflags. Standardeinstellung ist ohne Flags.

--use-k8s

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sql mi-arc upgrade

Hiermit wird eine verwaltete SQL-Instanz geupgradet.

Führt ein Upgrade einer verwalteten SQL-Instanz auf die angegebene gewünschte Version (desired-version) durch. Wenn die gewünschte Version (desired-version) nicht angegeben ist, wird die Datencontrollerversion verwendet.

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

Beispiele

Hiermit wird eine verwaltete SQL-Instanz geupgradet.

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

Optionale Parameter

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

Standardwert: False
--k8s-namespace -k

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

--label-filter -l

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

--name -n

Der Name der verwalteten SQL-Instanz.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--resource-group -g

Die Azure-Ressourcengruppe, in der die Arc-fähige SQL-Ziel-verwaltete Instanz vorhanden ist.

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.