Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Note
Diese Informationen gelten für Databricks CLI-Versionen 0.205 und höher. Die Databricks CLI befindet sich in der öffentlichen Vorschau.
Die Verwendung von Databricks CLI unterliegt der Datenbricks-Lizenz - und Databricks-Datenschutzerklärung, einschließlich der Bestimmungen zu Nutzungsdaten.
Mit warehouses der Befehlsgruppe in der Databricks CLI können Sie SQL-Lagerhäuser verwalten. Ein SQL Warehouse ist eine Computeressource, mit der Sie SQL-Befehle für Datenobjekte in Databricks SQL ausführen können. Siehe Herstellen einer Verbindung mit einem SQL-Warehouse.
Databricks-Warenlager erstellen
Erstellen Sie ein neues SQL Warehouse.
databricks warehouses create [flags]
Arguments
None
Options
--auto-stop-mins int
Die Zeitspanne in Minuten, die ein SQL-Lager im Leerlauf (d. h. keine RUNNING Abfragen) sein muss, bevor es automatisch beendet wird.
--cluster-size string
Größe der für dieses Lager zugewiesenen Cluster.
--creator-name string
Name des Warehouse-Erstellers.
--enable-photon
Konfiguriert, ob das Lager photonoptimierte Cluster verwenden soll.
--enable-serverless-compute
Konfiguriert, ob das Lager serverlose Compute verwenden soll.
--instance-profile-arn string
Deprecated.
--json JSON
Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.
--max-num-clusters int
Maximale Anzahl von Clustern, die vom Autoscaler erstellt werden, um gleichzeitige Abfragen zu verarbeiten.
--min-num-clusters int
Mindestanzahl verfügbarer Cluster, die für dieses SQL-Warehouse verwaltet werden.
--name string
Logischer Name für den Cluster.
--no-wait
Warten Sie nicht, bis der Zustand "RUNNING" erreicht ist.
--spot-instance-policy SpotInstancePolicy
Konfigurationen, ob das Warehouse Spot-Instanzen verwenden soll. Unterstützte Werte: COST_OPTIMIZED, POLICY_UNSPECIFIED, RELIABILITY_OPTIMIZED
--timeout duration
Maximale Zeitspanne bis zum Erreichen RUNNING des Zustands (Standard 20 ms)
--warehouse-type CreateWarehouseRequestWarehouseType
Lagertyp: PRO oder CLASSIC. Unterstützte Werte: CLASSIC, PRO, TYPE_UNSPECIFIED
Examples
Im folgenden Beispiel wird ein neues SQL Warehouse mit grundlegender Konfiguration erstellt:
databricks warehouses create --name "my-warehouse" --cluster-size "Small" --min-num-clusters 1 --max-num-clusters 10 --auto-stop-mins 60
Im folgenden Beispiel wird ein serverloses Lagerhaus mit aktiviertem Photon erstellt:
databricks warehouses create --name "serverless-warehouse" --enable-serverless-compute --enable-photon --warehouse-type PRO
databricks warehouses create-default-warehouse-override
Erstellen Sie eine Standardlagerüberschreibung für einen Benutzer. Benutzer können eine eigene Außerkraftsetzung erstellen. Administratoren können Außerkraftsetzungen für jeden Benutzer erstellen.
databricks warehouses create-default-warehouse-override DEFAULT_WAREHOUSE_OVERRIDE_ID TYPE [flags]
Arguments
DEFAULT_WAREHOUSE_OVERRIDE_ID
Die ID für die Außerkraftsetzung. Verwenden Sie eine numerische Benutzer-ID oder die Literalzeichenfolge me für den aktuellen Benutzer.
TYPE
Der Typ des Außerkraftsetzungsverhaltens. Unterstützte Werte: CUSTOM, LAST_SELECTED.
Options
--json JSON
Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.
--name string
Der Ressourcenname der Außerkraftsetzung des Standardlagers.
--warehouse-id string
Die spezifische Lager-ID, wenn typ ist CUSTOM.
Examples
Im folgenden Beispiel wird eine benutzerdefinierte Lagerlagerüberschreibung für den aktuellen Benutzer erstellt:
databricks warehouses create-default-warehouse-override me CUSTOM --warehouse-id 1234567890abcdef
Databricks-Warehouses löschen
Löschen Eines SQL-Lagerlagers.
databricks warehouses delete ID [flags]
Arguments
ID
Required. ID des SQL-Lagers.
Options
Examples
Im folgenden Beispiel wird ein Lager mit der angegebenen ID gelöscht:
databricks warehouses delete 1234567890abcdef
databricks warehouses delete-default-warehouse-override
Löschen Sie die Standardüberschreibung des Lagerlagers für einen Benutzer. Benutzer können ihre eigene Außerkraftsetzung löschen. Administratoren können Außerkraftsetzungen für jeden Benutzer löschen. Nach dem Löschen wird das Standardlager des Arbeitsbereichs verwendet.
databricks warehouses delete-default-warehouse-override NAME [flags]
Arguments
NAME
Der Ressourcenname der zu löschenden Standardlagerüberschreibung. Format: default-warehouse-overrides/{default_warehouse_override_id}. Die ID kann eine numerische Benutzer-ID oder die Literalzeichenfolge me für den aktuellen Benutzer sein.
Options
Examples
Im folgenden Beispiel wird die Außerkraftsetzung des Standardlagers für den aktuellen Benutzer gelöscht:
databricks warehouses delete-default-warehouse-override default-warehouse-overrides/me
Databricks-Lagerhäuser bearbeiten
Lagerhaus aktualisieren. Aktualisiert die Konfiguration für ein SQL Warehouse.
databricks warehouses edit ID [flags]
Arguments
ID
Required. Id des zu konfigurierenden Lagers.
Options
--auto-stop-mins int
Die Zeitspanne in Minuten, die ein SQL-Lager im Leerlauf (d. h. keine RUNNING Abfragen) sein muss, bevor es automatisch beendet wird.
--cluster-size string
Größe der für dieses Lager zugewiesenen Cluster.
--creator-name string
Name des Warehouse-Erstellers.
--enable-photon
Konfiguriert, ob das Lager photonoptimierte Cluster verwenden soll.
--enable-serverless-compute
Konfiguriert, ob das Lager serverlose Compute verwenden soll.
--instance-profile-arn string
Deprecated.
--json JSON
Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.
--max-num-clusters int
Maximale Anzahl von Clustern, die vom Autoscaler erstellt werden, um gleichzeitige Abfragen zu verarbeiten.
--min-num-clusters int
Mindestanzahl verfügbarer Cluster, die für dieses SQL-Warehouse verwaltet werden.
--name string
Logischer Name für den Cluster.
--no-wait
Warten Sie nicht, bis Sie den RUNNING Status erreichen.
--spot-instance-policy SpotInstancePolicy
Konfigurationen, ob das Warehouse Spot-Instanzen verwenden soll. Unterstützte Werte: COST_OPTIMIZED, POLICY_UNSPECIFIED, RELIABILITY_OPTIMIZED
--timeout duration
Maximale Zeitspanne bis zum Erreichen RUNNING des Zustands (Standard 20 ms)
--warehouse-type EditWarehouseRequestWarehouseType
Lagertyp. Unterstützte Werte: CLASSIC, PRO, TYPE_UNSPECIFIED
Examples
Im folgenden Beispiel wird ein Lager aktualisiert, um seine Clustergröße und die Automatische Stoppzeit zu ändern:
databricks warehouses edit 1234567890abcdef --cluster-size "Medium" --auto-stop-mins 30
Im folgenden Beispiel wird Photon für ein vorhandenes Lager aktiviert:
databricks warehouses edit 1234567890abcdef --enable-photon
Abfrage von Databricks-Lagerhäusern
Rufen Sie die Informationen für ein einzelnes SQL Warehouse ab.
databricks warehouses get ID [flags]
Arguments
ID
Required. ID des SQL-Lagers.
Options
Examples
Das folgende Beispiel ruft Informationen zu einem Lagerhaus mit der angegebenen ID ab:
databricks warehouses get 1234567890abcdef
databricks warehouses get-default-warehouse-override
Rufen Sie die Standardmäßige Lagerüberschreibung für einen Benutzer ab. Benutzer können ihre eigene Außerkraftsetzung abrufen. Administratoren können Außerkraftsetzungen für jeden Benutzer abrufen. Wenn keine Außerkraftsetzung vorhanden ist, wird das Standardlager des Arbeitsbereichs verwendet.
databricks warehouses get-default-warehouse-override NAME [flags]
Arguments
NAME
Der Ressourcenname der Standardlagerüberschreibung, die abgerufen werden soll. Format: default-warehouse-overrides/{default_warehouse_override_id}. Die ID kann eine numerische Benutzer-ID oder die Literalzeichenfolge me für den aktuellen Benutzer sein.
Options
Examples
Im folgenden Beispiel wird die Außerkraftsetzung des Standardlagers für den aktuellen Benutzer ermittelt:
databricks warehouses get-default-warehouse-override default-warehouse-overrides/me
databricks warehouses get-workspace-warehouse-config
Rufen Sie die Konfiguration auf Arbeitsbereichsebene ab, die von allen SQL-Lagerhäusern in einem Arbeitsbereich gemeinsam verwendet wird.
databricks warehouses get-workspace-warehouse-config [flags]
Arguments
None
Options
Examples
Das folgende Beispiel ruft den Arbeitsbereich Warehouse-Konfiguration ab:
databricks warehouses get-workspace-warehouse-config
Databricks Lagerliste
Auflisten aller SQL-Lagerhäuser, für die ein Benutzer über Berechtigungen verfügt.
databricks warehouses list [flags]
Arguments
None
Options
--run-as-user-id int
Dienstprinzipal, das zum Abrufen der Liste der Warehouses verwendet wird.
Examples
Im folgenden Beispiel werden alle Lagerhäuser aufgelistet:
databricks warehouses list
Im folgenden Beispiel werden Lagerhäuser mit einem bestimmten Dienstprinzipal aufgelistet:
databricks warehouses list --run-as-user-id 123456789
databricks warehouses list-default-warehouse-overrides
Listet alle Standardlagerüberschreibungen im Arbeitsbereich auf. Nur Arbeitsbereichsadministratoren können alle Außerkraftsetzungen auflisten.
databricks warehouses list-default-warehouse-overrides [flags]
Options
--page-size int
Die maximale Anzahl der zurückzugebenden Außerkraftsetzungen.
--page-token string
Ein Seitentoken, das von einem vorherigen list-default-warehouse-overrides Aufruf empfangen wurde.
Examples
Im folgenden Beispiel werden alle Standardlagerüberschreibungen aufgelistet:
databricks warehouses list-default-warehouse-overrides
databricks warehouses „set-workspace-warehouse-config“
Legen Sie die Konfiguration auf Arbeitsbereichsebene fest, die von allen SQL-Lagerhäusern in einem Arbeitsbereich gemeinsam verwendet wird.
databricks warehouses set-workspace-warehouse-config [flags]
Arguments
None
Options
--google-service-account string
Nur GCP: Google Dienst-Konto, das verwendet wird, um dem Cluster den Zugriff auf Google Cloud Storage zu ermöglichen.
--instance-profile-arn string
Nur AWS: Instanzprofil, das verwendet wird, um die IAM-Rolle an den Cluster zu übergeben.
--json JSON
Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.
--security-policy SetWorkspaceWarehouseConfigRequestSecurityPolicy
Sicherheitsrichtlinie für Lagerhäuser. Unterstützte Werte: DATA_ACCESS_CONTROL, NONE, PASSTHROUGH
Examples
Im folgenden Beispiel wird die Arbeitsbereichslagerkonfiguration mit einer Sicherheitsrichtlinie festgelegt:
databricks warehouses set-workspace-warehouse-config --security-policy DATA_ACCESS_CONTROL
Databricks-Datenlager starten
Starten Sie ein SQL-Lagerhaus.
databricks warehouses start ID [flags]
Arguments
ID
Required. ID des SQL-Lagers.
Options
--no-wait
Warten Sie nicht, bis Sie den RUNNING Status erreichen.
--timeout duration
Maximale Zeitspanne bis zum Erreichen RUNNING des Zustands (Standard 20 ms)
Examples
Im folgenden Beispiel wird ein Lager mit der angegebenen ID gestartet:
databricks warehouses start 1234567890abcdef
Im folgenden Beispiel wird ein Lager gestartet, ohne darauf zu warten, dass es in den Zustand RUNNING gelangt.
databricks warehouses start 1234567890abcdef --no-wait
Databricks-Lager stoppen
Stoppen Sie ein SQL-Datenlager.
databricks warehouses stop ID [flags]
Arguments
ID
Required. ID des SQL-Lagers.
Options
--no-wait
Warten Sie nicht, bis Sie den STOPPED Status erreichen.
--timeout duration
Maximale Zeitspanne bis zum Erreichen STOPPED des Zustands (Standard 20 ms)
Examples
Im folgenden Beispiel wird ein Lager mit der angegebenen ID beendet:
databricks warehouses stop 1234567890abcdef
Im folgenden Beispiel wird ein Lager beendet, ohne darauf zu warten, dass er den Zustand erreicht STOPPED :
databricks warehouses stop 1234567890abcdef --no-wait
databricks warehouses update-default-warehouse-override
Aktualisieren sie eine vorhandene Standardlagerüberschreibung für einen Benutzer. Benutzer können ihre eigene Außerkraftsetzung aktualisieren. Administratoren können Außerkraftsetzungen für jeden Benutzer aktualisieren.
databricks warehouses update-default-warehouse-override NAME UPDATE_MASK TYPE [flags]
Arguments
NAME
Der Ressourcenname der Außerkraftsetzung des Standardlagers. Format: default-warehouse-overrides/{default_warehouse_override_id}.
UPDATE_MASK
Feldformat, das angibt, welche Felder aktualisiert werden sollen. Wird verwendet * , um alle Felder zu aktualisieren. Wenn --allow-missing dieses Feld festgelegt ist, wird dieses Feld ignoriert, und alle Felder werden angewendet.
TYPE
Der Typ des Außerkraftsetzungsverhaltens. Unterstützte Werte: CUSTOM, LAST_SELECTED.
Options
--allow-missing
Wenn festgelegt und die Außerkraftsetzung nicht gefunden wird, erstellen Sie stattdessen eine neue Außerkraftsetzung.
--json JSON
Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.
--name string
Der Ressourcenname der Außerkraftsetzung des Standardlagers.
--warehouse-id string
Die spezifische Lager-ID, wenn typ ist CUSTOM.
Examples
Im folgenden Beispiel wird die Außerkraftsetzung des aktuellen Benutzers auf ein bestimmtes Lager aktualisiert:
databricks warehouses update-default-warehouse-override default-warehouse-overrides/me warehouse_id CUSTOM --warehouse-id 1234567890abcdef
databricks-Warehouses Berechtigungsebenen-abrufen
Rufen Sie SQL Warehouse-Berechtigungsstufen ab.
databricks warehouses get-permission-levels WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
Das SQL-Lager, für das Berechtigungen abgerufen oder verwaltet werden sollen.
Options
Examples
Das folgende Beispiel ruft die Berechtigungsstufen für ein Lager ab:
databricks warehouses get-permission-levels 1234567890abcdef
databricks warehouses Berechtigungen abrufen
Erhalten Sie die Berechtigungen eines SQL-Warehouses. SQL-Lagerhäuser können Berechtigungen von ihrem Stammobjekt erben.
databricks warehouses get-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
Das SQL-Lager, für das Berechtigungen abgerufen oder verwaltet werden sollen.
Options
Examples
Das folgende Beispiel ruft die Berechtigungen für ein Warehouse ab:
databricks warehouses get-permissions 1234567890abcdef
Databricks Warehouses Berechtigungen festlegen
Legen Sie SQL Warehouse-Berechtigungen fest. Legt Berechtigungen für ein Objekt fest und ersetzt vorhandene Berechtigungen, falls vorhanden. Löscht alle direkten Berechtigungen, wenn keine angegeben sind. Objekte können Berechtigungen von ihrem Root-Objekt erben.
databricks warehouses set-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
Das SQL-Lager, für das Berechtigungen abgerufen oder verwaltet werden sollen.
Options
--json JSON
Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.
Examples
Im folgenden Beispiel werden Berechtigungen für ein Lagerhaus mithilfe einer JSON-Datei festgelegt:
databricks warehouses set-permissions 1234567890abcdef --json @permissions.json
databricks warehouses Berechtigungen aktualisieren
Aktualisieren Sie die Berechtigungen für ein SQL-Lagerhaus. SQL-Lagerhäuser können Berechtigungen von ihrem Stammobjekt erben.
databricks warehouses update-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
Das SQL-Lager, für das Berechtigungen abgerufen oder verwaltet werden sollen.
Options
--json JSON
Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.
Examples
Im folgenden Beispiel werden Berechtigungen für ein Lager mit einer JSON-Datei aktualisiert:
databricks warehouses update-permissions 1234567890abcdef --json @permissions.json
Globale Kennzeichnungen
--debug
Ob die Debug-Protokollierung aktiviert werden soll.
-h oder --help
Hilfe für die Databricks CLI oder die zugehörige Befehlsgruppe oder den zugehörigen Befehl anzeigen.
--log-file Zeichenfolge
Eine Zeichenfolge, die die Datei darstellt, in die Ausgabeprotokolle geschrieben werden sollen. Wenn dieses Flag nicht angegeben ist, werden Ausgabeprotokolle standardmäßig in stderr geschrieben.
--log-format Format
Der Typ des Protokollformats, text oder json. Der Standardwert ist text.
--log-level Zeichenfolge
Eine Zeichenfolge, die die Protokollformatebene darstellt. Wenn nicht angegeben, ist die Protokollformatebene deaktiviert.
-o, --output Typ
Der Typ der Befehlsausgabe, text oder json. Der Standardwert ist text.
-p, --profile Zeichenfolge
Der Name des Profils in der Datei ~/.databrickscfg, das zum Ausführen des Befehls verwendet werden soll. Wenn dieses Flag nicht angegeben wird, wird, falls vorhanden, das Profil mit dem Namen DEFAULT verwendet.
--progress-format Format
Das Format für die Anzeige der Fortschrittsprotokolle: default, append, inplace, oder json
-t, --target Zeichenfolge
Falls zutreffend, das zu verwendende Bundle-Ziel