Anmerkung
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen, dich anzumelden oder die Verzeichnisse zu wechseln.
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen , die Verzeichnisse 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 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-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 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-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 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 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-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 get-permissions
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