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.
Serverlose Compute-Richtlinien ermöglichen es Workspace-Admins, den Zugriff auf unterstützte serverlose Rechenprodukte zu steuern, deren Konfiguration zu begrenzen und Tags auf neu erstellte Rechenressourcen durchzusetzen. Diese Seite erklärt, wie man Richtlinien erstellt, Zugriff gewährt und diese mit Lakebase verwendet.
Important
Serverlose Rechenrichtlinien befinden sich in der Privatvorschau und werden über die REST-API verwaltet. Die Vorschau unterstützt Lakebase. Wenden Sie sich an Ihr Databricks-Kontoteam, um Zugriff anzufordern.
Requirements
- Ihr Arbeitsbereich muss für die Vorschau der Serverless-Compute-Richtlinie registriert sein und Zugriff auf Lakebase haben. Informationen zur Verfügbarkeit von Lakebase nach Region finden Sie unter Regionverfügbarkeit.
- Sie müssen ein Workspace-Administrator sein, um eine Richtlinie zu erstellen. Um eine bestehende Richtlinie zu lesen oder zu verwenden, benötigen Sie
CAN_USEoderCAN_MANAGEfür diese Richtlinie. Um eine benutzerdefinierte Richtlinie zu aktualisieren oder zu löschen oder die Berechtigungen einer Richtlinie zu verwalten, benötigen SieCAN_MANAGE. - Die Beispiele verwenden
curl,jq, und einen Workspace-OAuth-Token. Das Authentifizierungsbeispiel verwendet die Databricks-CLI.
Wie serverlose Rechenrichtlinien funktionieren
Eine serverlose Rechenrichtlinie gehört zu einem Arbeitsbereich. Das zugehörige allowed_compute_products Objekt legt fest, welche Compute-Produkte ein Benutzer über die Richtlinie verwenden kann und welche Grenzwerte für die Konfiguration der einzelnen Produkte gelten. Gewähren Sie über eine Richtlinie Zugriff, damit Nutzer die zugelassenen Produkte innerhalb dieser Grenzen nutzen können.
Nach der Erstellung regelt die angehängte Richtlinie Änderungen an der Konfiguration der Compute-Instanz, solange die Richtlinie existiert. Das Straffen einer Richtlinie ändert keine bestehende Compute-Ressource. Nachfolgende Aktualisierungen der von der Richtlinie geregelten Einstellungen müssen deren aktuellen Einschränkungen genügen. Zum Beispiel muss eine Kapazitätsänderung von Lakebase innerhalb des aktuellen Maximums der Richtlinie passen, gemessen in Recheneinheiten (CU).
Für Richtlinien, die klassische Berechnung steuern, siehe Klassische Rechenrichtlinien erstellen und verwalten.
Berechtigungen für Konfigurationsänderungen
Das Aktualisieren der Einstellungen einer Ressource oder das Ersetzen ihrer Rechenrichtlinie erfordert die folgenden Berechtigungen:
| Konfigurationsänderung | Erforderliche Berechtigungen |
|---|---|
| Ändern Sie Einstellungen außerhalb des Anwendungsbereichs der Richtlinie | Berechtigung zur Verwaltung der Ressource. Eine Berechtigung zur Verwendung der Richtlinie ist nicht erforderlich. |
| Recheneinstellungen ändern, die durch die Richtlinie geregelt werden | Berechtigung zur Verwaltung der Ressource und CAN_USE /oder CAN_MANAGE für die Richtlinie, auch wenn keine Grenze für die Einstellung gesetzt wird. |
| Die angehängte Richtlinie ersetzen | Berechtigung zur Verwaltung der Ressource und CAN_USE oder CAN_MANAGE sowohl für die aktuelle Richtlinie als auch für deren Ersatz. |
Die Berechtigung zur Verwaltung einer Ressource hängt vom Produkt ab. Zum Beispiel kann ein Benutzer mit CAN_MANAGE für ein Lakebase-Projekt den Anzeigenamen des Projekts ändern, ohne Zugriff auf dessen Compute-Richtlinie zu haben. Die Änderung der Rechenkapazität oder der Skalierungs-zu-null-Einstellungen erfordert die Nutzungsberechtigung der Richtlinie, auch wenn die Richtlinie keine Kapazitäts- oder Leerlaufzeitbegrenzungen festlegt.
Die Berechtigung zur Verwendung einer Richtlinie umgeht ihre Einschränkungen nicht. Aktualisierte Einstellungen müssen die Grenzen der Richtlinie erfüllen und die erforderlichen Tag-Schlüssel-Wert-Paare beibehalten.
Sie können eine Richtlinie nicht aus einer Ressource entfernen, ohne einen Ersatz zuzuweisen. Für ein Lakebase-Projekt muss die Ersatzrichtlinie Lakebase zulassen. Das Zurücksetzen spec.compute_policy_id weist die Standard-Lakebase-Richtlinie als Ersatz zu und erfordert dieselben Berechtigungen.
Richtlinien-Tags
Verwenden Sie die optionale Top-Level-Map tags , um Schlüsselwert-Tags neben display_name und allowed_compute_productsanzugeben. Tagschlüssel und -werte sind Zeichenfolgen. Eine Richtlinie kann bis zu 20 Tags enthalten, und jeder Schlüssel muss nicht leer sein.
Tags aus einer serverlosen Rechenrichtlinie übertragen sich auf die mit dieser Richtlinie erstellten Rechenressourcen. Die Richtlinie setzt diese Tags durch, solange die Richtlinie existiert und weiterhin angehängt bleibt. Änderungen an den Tags der Compute-Ressource müssen die von der beigefügten Richtlinie erforderlichen Schlüssel-Wert-Paare erhalten.
Serverless-Nutzungsrichtlinien, auch serverless-Budgetrichtlinien genannt, weisen Tags zur Kostenzuschreibung zu und verwenden eine separate Richtlinien-ID. Sie können eine Serverless-Nutzungsrichtlinie zusammen mit einer Serverless-Compute-Richtlinie verwenden. Der erstellte Compute erhält die Vereinigung der Tags beider Richtlinien. Wenn zum Beispiel die Compute-Richtlinie environment=development angibt und die Nutzungsrichtlinie cost_center=engineering angibt, erhält die Compute beide Tags.
Lakebase-Richtlinieneinstellungen
Um Lakebase über eine serverlose Rechenrichtlinie zuzulassen, fügen Sie allowed_compute_products in lakebase ein.
Erstellung des Lakebase-Projekts
Die Erstellung eines Lakebase-Projekts erfordert CAN_USE oder CAN_MANAGE für eine Richtlinie, die Lakebase erlaubt. Wenn Sie ein Lakebase-Projekt erstellen, erhalten Sie automatisch CAN_MANAGE darauf.
Richtlinienberechtigungen gewähren keinen Zugriff auf bestehende Lakebase-Projekte oder deren Daten. Lakebase-Projektberechtigungen steuern das Ressourcenmanagement, wobei zusätzliche Richtlinienberechtigungen erforderlich sind, um Recheneinstellungen zu ändern, die durch eine Richtlinie geregelt werden. Postgres-Rollen und Berechtigungen steuern den Datenbankzugriff.
Kapazitäts- und Leerlaufzeitbegrenzungen
Stellen Sie unter allowed_compute_products.lakebase eines oder beide der folgenden Felder ein:
| Field | Description |
|---|---|
max_capacity_units_per_instance |
Maximale Kapazität in Lakebase CU. Für einen automatisch skalierenden Compute muss das konfigurierte Maximum innerhalb dieses Limits liegen. |
max_idle_minutes_before_scale_to_zero |
Maximales Inaktivitätszeitlimit in Minuten, bevor der Compute auf null skaliert. Ein Compute, dem dieses Limit unterliegt, muss Scale-to-Zero aktiviert haben, mit einem Timeout bei oder unter dem Limit. |
Beide Felder akzeptieren positive ganze Zahlen. Das Auslassen eines Feldes setzt für diese Einstellung keine Richtliniengrenze. Ein leeres lakebase Objekt erlaubt Lakebase ohne eine der beiden Grenzen. Eine Richtlinie muss ein lakebase Objekt enthalten, um Lakebase zuzulassen.
Zum Beispiel begrenzt das folgende lakebase Objekt jedes Compute auf 16 CU und erfordert nach höchstens 15 Minuten Inaktivität eine Skalierung auf null:
{
"max_capacity_units_per_instance": 16,
"max_idle_minutes_before_scale_to_zero": 15
}
Diese Beschränkungen ergänzen die unterstützten Computegrößen und die Einstellungen für das Herunterskalieren auf null. Eine Richtlinie macht eine nicht unterstützte Konfiguration nicht verfügbar. Siehe Einschränkungen für Konfigurationen, die nicht auf Null skaliert werden können.
Standard-Lakebase-Richtlinie
Die Standard-Lakebase-Richtlinie des Arbeitsbereichs erlaubt Lakebase ohne Kapazitäts- oder Leerlaufzeitbegrenzungen. Workspace-Benutzer können diese Richtlinie standardmäßig verwenden, um Lakebase-Projekte zu erstellen.
Workspace-Administratoren können Berechtigungen für die Standard-Lakebase-Richtlinie über die Berechtigungs-API gewähren oder widerrufen. Sie können die Richtlinie nicht löschen oder ihren Namen oder ihre Konfiguration ändern.
Wenn Sie ein Lakebase-Projekt erstellen, ohne eine Computing-Richtlinie anzugeben, verwendet die Anfrage die Default Lakebase Policy. Sie müssen die Erlaubnis haben, diese Richtlinie zu verwenden. Das Erstellen einer benutzerdefinierten Richtlinie widerruft nicht den Zugriff auf die Standardrichtlinie und wendet die benutzerdefinierte Richtlinie nicht automatisch auf bestehende Lakebase-Projekte an. Um von Benutzern zu verlangen, eine benutzerdefinierte Richtlinie auszuwählen, siehe Eine benutzerdefinierte Richtlinie für die Erstellung eines Lakebase-Projekts verlangen.
API-Authentifizierung einrichten
Verwenden Sie für diese Anfragen Ihre Workspace-URL und einen Workspace-OAuth-Token. Siehe Benutzerzugriff auf Azure Databricks mit OAuth autorisieren für Details zur Authentifizierung.
Setzen Sie
WORKSPACEauf Ihre Workspace-URL, ohne abschließenden Schrägstrich:export WORKSPACE="https://<workspace-host>"Authentifizieren Sie sich bei diesem Arbeitsbereich:
databricks auth login --host "$WORKSPACE"Einen OAuth-Token für die authentifizierte Identität abrufen:
export DATABRICKS_TOKEN="$(databricks auth token --host "$WORKSPACE" | jq -r .access_token)"
Aktualisieren Sie den Token, falls er abläuft. Führen Sie jede Anfrage als Identität mit den erforderlichen Berechtigungen aus.
Eine Richtlinie erstellen
Das folgende Beispiel erstellt eine serverlose Rechenrichtlinie, die Lakebase erlaubt:
Senden Sie als Workspace-Administrator die folgende Anfrage. Sie erstellt eine Richtlinie mit einem Maximum von 16 CU, einem maximalen 15-minütigen Inaktivitäts-Timeout und einem erzwungenen
environment=developmentTag:curl --fail-with-body -sS -X POST "$WORKSPACE/api/2.0/policies/compute" \ -H "Authorization: Bearer $DATABRICKS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "display_name": "Lakebase development", "allowed_compute_products": { "lakebase": { "max_capacity_units_per_instance": 16, "max_idle_minutes_before_scale_to_zero": 15 } }, "tags": { "environment": "development" } }'Kopieren Sie das
compute_policy_idaus der Antwort und setzen Sie es für nachfolgende Anfragen:export COMPUTE_POLICY_ID="<compute-policy-id>"Rufen Sie die Richtlinie ab, um ihren Namen und die Produktbeschränkungen zu überprüfen. Diese Antwort enthält nicht die Tags der Richtlinie:
curl --fail-with-body -sS "$WORKSPACE/api/2.0/policies/compute/$COMPUTE_POLICY_ID" \ -H "Authorization: Bearer $DATABRICKS_TOKEN"
Der Anfragetext ist das Richtlinienobjekt selbst. Der Dienst weist compute_policy_id zu. Wählen Sie einen eindeutigen Anzeigenamen im Arbeitsbereich aus, von 1 bis 127 Zeichen.
Zugriff auf eine Richtlinie gewähren
Verwenden Sie die Berechtigungs-API mit dem Objekttyp compute-policy. Der Policy-Ersteller hat CAN_MANAGE.
Als Identität mit
CAN_MANAGE, erteilen Sie einer bestehenden Arbeitsbereichsgruppe die Berechtigung zur Nutzung der Richtlinie. Ersetzen Sielakebase-developersdurch den Namen Ihrer Gruppe:curl --fail-with-body -sS -X PATCH \ "$WORKSPACE/api/2.0/permissions/compute-policy/$COMPUTE_POLICY_ID" \ -H "Authorization: Bearer $DATABRICKS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "access_control_list": [ { "group_name": "lakebase-developers", "permission_level": "CAN_USE" } ] }'Überprüfen Sie die Berechtigung:
curl --fail-with-body -sS \ "$WORKSPACE/api/2.0/permissions/compute-policy/$COMPUTE_POLICY_ID" \ -H "Authorization: Bearer $DATABRICKS_TOKEN"
Verwenden Sie user_name, um einem Benutzer Zugriff zu gewähren, oder service_principal_name mit der Anwendungs-ID eines Service-Principals. Erlauben Sie CAN_MANAGE, einem Principal zu erlauben, die Richtlinie zu verwenden und dessen Berechtigungen zu verwalten. Für benutzerdefinierte Richtlinien erlaubt CAN_MANAGE außerdem, die Konfiguration zu aktualisieren und die Richtlinie zu löschen.
PATCH aktualisiert die angegebenen Berechtigungen.
PUT ersetzt die direkten Berechtigungszuweisungen, also füge den vollständigen Satz hinzu, den du behalten möchtest.
Erfordern Sie eine benutzerdefinierte Richtlinie für die Erstellung von Lakebase-Projekten
Als Workspace-Administrator verwenden Sie die folgenden Schritte, um von Benutzern zu verlangen, eine benutzerdefinierte Richtlinie auszuwählen:
-
Liste Richtlinien auf, wobei du beliebige
next_page_tokenWerte befolgst. Finden Sie die Standard-Lakebase-Richtlinie anhand ihresis_defaultWerts undlakebaseEintrags inallowed_compute_products. Kopiere escompute_policy_id. - Gewähren Sie betroffenen Benutzern oder Gruppen Zugriff auf eine benutzerdefinierte Richtlinie, die den Zugriff auf Lakebase erlaubt.
- Für bestehende Lakebase-Projekte, die die Standardrichtlinie verwenden, ersetzen Sie deren Richtlinie , falls Benutzer weiterhin geregelte Recheneinstellungen ändern müssen. Das Widerrufen des Zugriffs auf die Standardrichtlinie verhindert diese Änderungen auf Compute, das sie noch verwendet.
- Rufen Sie die Berechtigungen der Standardrichtlinie mit
GET /api/2.0/permissions/compute-policy/<default-policy-id>ab. Überprüfen Sie sowohl Nutzer- als auch Gruppenberechtigungen. Die Standardrichtlinie gewährt zunächst Zugriff auf dieusersGruppe, sodass das Entfernen einer direkten Benutzergewährung allein den Zugriff dieses Benutzers nicht entfernt. -
Ersetzen Sie die direkten Berechtigungszuweisungen durch
PUT /api/2.0/permissions/compute-policy/<default-policy-id>. Fügen Sie die direkten Berechtigungen, die Sie behalten möchten, inaccess_control_listein, und lassen Sie Berechtigungen weg, die den betroffenen Benutzern Zugriff gewähren. Ersetzen Sie die breiteusersBerechtigung durch Berechtigungen für bestimmte Gruppen, falls einige Benutzer den durch die Standardrichtlinie gewährten Zugriff beibehalten sollten. Jeder Anfrageeintrag verwendet einen Prinzipalnamen undpermission_level, wie im Grant-Beispiel. Senden Sie die Berechtigungen-GET-Antwort nicht unverändert als PUT-Body. - Als betroffener Benutzer listen Sie die Richtlinien erneut auf. Stellen Sie sicher, dass die benutzerdefinierte Richtlinie verfügbar ist und die Standardrichtlinie nicht mehr verfügbar ist. Der Benutzer muss nun beim Erstellen eines Lakebase-Projekts eine benutzerdefinierte Richtlinien-ID angeben.
Eine Richtlinie mit Lakebase-Projekten verwenden
Verwenden Sie die Postgres-API (/api/2.0/postgres/), um Lakebase-Projekte zu erstellen und zu verwalten. Ein Lakebase-Projekt enthält Zweige, und Rechenendpunkte liefern die Rechenleistung für diese Zweige. Siehe Compute und Endpunkte.
Wählen Sie eine Rechenrichtlinie mit spec.compute_policy_id aus, wenn Sie ein Lakebase-Projekt erstellen. Die angehängte Richtlinie steuert die Rechenkonfiguration und setzt die erforderlichen Tags auf dem zugehörigen Compute durch. Richtlinienverwaltung verwendet die separate /api/2.0/policies/compute API.
Ein Lakebase-Projekt mit einer Richtlinie erstellen
Verwenden Sie eine Identität mit CAN_USE oder CAN_MANAGE für die oben erstellte Richtlinie:
Erstellen Sie ein Lakebase-Projekt mit einem Autoskalierungsbereich von 2–8 CU und einer 15-minütigen Inaktivitätszeit:
curl --fail-with-body -sS -X POST \ "$WORKSPACE/api/2.0/postgres/projects?project_id=policy-example" \ -H "Authorization: Bearer $DATABRICKS_TOKEN" \ -H "Content-Type: application/json" \ -d "$(jq -n --arg policy_id "$COMPUTE_POLICY_ID" '{ "spec": { "display_name": "Policy example", "compute_policy_id": $policy_id, "default_endpoint_settings": { "autoscaling_limit_min_cu": 2, "autoscaling_limit_max_cu": 8, "suspend_timeout_duration": "900s" } } }')"Die Kapazitätswerte werden in Lakebase CU angegeben. Das Maximum von 8 CU liegt innerhalb des 16-CU-Limits der Richtlinie. Lakebase gibt das Inaktivitäts-Timeout als Dauer in Sekunden an:
"900s"entspricht dem 15-Minuten-Limit der Richtlinie. Diese Standardeinstellungen konfigurieren das anfängliche Compute und liefern die Starteinstellungen für neue Computes im Lakebase-Projekt.Um auch eine Richtlinie für serverlose Nutzung anzuwenden, fügen Sie
"budget_policy_id": "<usage-policy-id>"innerhalb vonspechinzu, wobei Sie die ID einer Richtlinie verwenden, die Sie verwenden können. Compute erhält Tags von beiden Richtlinien.Kopieren Sie die Operation
nameaus der Antwort und setzen Sie sie für die Statusanfrage:export OPERATION_NAME="<operation-name>"Rufen Sie die Operation ab, bis
donetrueist:curl --fail-with-body -sS "$WORKSPACE/api/2.0/postgres/$OPERATION_NAME" \ -H "Authorization: Bearer $DATABRICKS_TOKEN"Wenn die Antwort
errorenthält, lösen Sie sie vor dem Fortfahren. Zum Erstellen, Aktualisieren und Löschen von Anfragen wird dieses Muster für lange laufende Vorgänge verwendet.
Lakebase-Projekte lesen und auflisten
Das Lakebase-Projekt abrufen:
curl --fail-with-body -sS "$WORKSPACE/api/2.0/postgres/projects/policy-example" \ -H "Authorization: Bearer $DATABRICKS_TOKEN"Überprüfen Sie, ob
status.compute_policy_idmit der von Ihnen ausgewählten Richtlinie übereinstimmt.Liste die Lakebase-Projekte auf, auf die du zugreifen kannst:
curl --fail-with-body -sS "$WORKSPACE/api/2.0/postgres/projects" \ -H "Authorization: Bearer $DATABRICKS_TOKEN"
Wenn die Listenantwort next_page_token enthält, geben Sie diesen Wert als page_token weiter, um die nächste Seite abzurufen.
Ein Lakebase-Projekt aktualisieren
Verwenden Sie eine Identität mit CAN_MANAGE für das Lakebase-Projekt. Die Änderung des Anzeigenamens erfordert keine Berechtigung zur Nutzung der Rechenrichtlinie.
Aktualisieren Sie den Anzeigenamen des Lakebase-Projekts und geben Sie das Feld in der Update-Maske an:
curl --fail-with-body -sS -X PATCH \ "$WORKSPACE/api/2.0/postgres/projects/policy-example?update_mask=spec.display_name" \ -H "Authorization: Bearer $DATABRICKS_TOKEN" \ -H "Content-Type: application/json" \ -d '{"spec": {"display_name": "Lakebase development"}}'Warten Sie, bis die zurückgegebene Operation abgeschlossen ist, und rufen Sie dann das Lakebase-Projekt ab, um die Änderung zu überprüfen.
Die Änderung der Kapazität oder der Skalierung-auf-Null-Standardwerte für die Rechenleistung eines Lakebase-Projekts erfordert außerdem CAN_USE oder CAN_MANAGE in der Richtlinie, selbst wenn für die Einstellung keine Grenze festgelegt ist. Die neuen Werte müssen alle geltenden Richtliniengrenzen erfüllen. Standardwerte gelten, wenn neue Computes erstellt werden. Um einen bestehenden Compute zu ändern, aktualisieren Sie seinen Endpunkt wie im folgenden Verfahren dargestellt.
Um die angehängte Richtlinie zu ändern, siehe Richtlinie eines Lakebase-Projekts ersetzen.
Lakebase-Rechenleistung aktualisieren
Das folgende Beispiel erhöht das Maximum der bestehenden Rechenleistung auf 16 CU und verkürzt dessen Inaktivitäts-Timeout auf 10 Minuten. Sie benötigen CAN_MANAGE im Lakebase-Projekt und CAN_USE /oder CAN_MANAGE in der Richtlinie:
Listen Sie die Endpunkte im
production-Branch des Lakebase-Projekts auf:curl --fail-with-body -sS \ "$WORKSPACE/api/2.0/postgres/projects/policy-example/branches/production/endpoints" \ -H "Authorization: Bearer $DATABRICKS_TOKEN"Kopieren Sie den Endpunkt
nameder ursprünglichen Compute-Instanz aus der Antwort. Der Name umfasst den Lakebase-Projekt, den Zweig und den Endpunktpfad:export ENDPOINT_NAME="<endpoint-name>"Aktualisieren Sie die maximalen CU- und Einstellungen für die Skalierung auf null. Verwenden Sie
spec.suspensionin der Update-Maske für das Inaktivitäts-Timeout:curl --fail-with-body -sS -X PATCH \ "$WORKSPACE/api/2.0/postgres/$ENDPOINT_NAME?update_mask=spec.autoscaling_limit_max_cu,spec.suspension" \ -H "Authorization: Bearer $DATABRICKS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "spec": { "autoscaling_limit_max_cu": 16, "suspend_timeout_duration": "600s" } }'Warten Sie, bis die zurückgegebene Operation abgeschlossen ist, und rufen Sie dann den Endpunkt ab:
curl --fail-with-body -sS "$WORKSPACE/api/2.0/postgres/$ENDPOINT_NAME" \ -H "Authorization: Bearer $DATABRICKS_TOKEN"Verifizieren Sie
status.autoscaling_limit_max_cuundstatus.suspend_timeout_duration.
Das aktualisierte Maximum entspricht dem Limit von 16 CU der Richtlinie, und "600s" liegt unter dem 15-minütigen Leerlauflimit. Für diese Compute-Instanz führen Anfragen über 16 CU, Inaktivitäts-Timeouts über 15 Minuten oder das Deaktivieren der Skalierungs-zu-Null-Einstellung zum Fehlschlagen der Richtlinienvalidierung. Wählen Sie Einstellungen innerhalb der Grenzen der Richtlinie aus oder bitten Sie einen Richtlinienmanager, diese zu überprüfen.
Die Richtlinie eines Lakebase-Projekts ersetzen
Sie benötigen CAN_MANAGE für das Lakebase-Projekt und CAN_USE oder CAN_MANAGE sowohl für die aktuelle Richtlinie als auch für deren Ersatz. Der Ersatz muss Lakebase ermöglichen.
Das Wechseln der Richtlinien ist eine Konfigurationsaktualisierung. Die bestehenden Compute- und Compute-Standardwerte des Lakebase-Projekts müssen die Einschränkungen der Ersatzrichtlinie erfüllen, bevor das Update abgeschlossen werden kann.
Wählen Sie eine Ersatzrichtlinie aus und legen Sie deren ID fest:
export REPLACEMENT_COMPUTE_POLICY_ID="<replacement-policy-id>"Stellen Sie sicher, dass die Compute-Standardeinstellungen des Lakebase-Projekts und die vorhandenen Compute-Ressourcen die Kapazitäts- und Leerlaufzeitgrenzen der Ersetzungsrichtlinie erfüllen. Aktualisieren Sie bestehende Rechenleistung und passen Sie die Standardeinstellungen gegebenenfalls an.
Aktualisieren Sie die Richtlinienzuweisung des Lakebase-Projekts:
curl --fail-with-body -sS -X PATCH \ "$WORKSPACE/api/2.0/postgres/projects/policy-example?update_mask=spec.compute_policy_id" \ -H "Authorization: Bearer $DATABRICKS_TOKEN" \ -H "Content-Type: application/json" \ -d "$(jq -n --arg policy_id "$REPLACEMENT_COMPUTE_POLICY_ID" '{ "spec": { "compute_policy_id": $policy_id } }')"Warten Sie darauf, dass die zurückgegebene Operation mit
done: trueabgeschlossen ist. Wenn es einerrorenthält, lösen Sie es, bevor Sie fortfahren.Rufen Sie das Lakebase-Projekt ab und überprüfen Sie, ob
status.compute_policy_idmit der Ersatzrichtlinien-ID übereinstimmt:curl --fail-with-body -sS "$WORKSPACE/api/2.0/postgres/projects/policy-example" \ -H "Authorization: Bearer $DATABRICKS_TOKEN"
Das Leeren von spec.compute_policy_id wählt die Standard-Lakebase-Richtlinie aus und erfordert deren Nutzungsberechtigung. Es lässt das Lakebase-Projekt nicht ohne eine Richtlinie zurück.
Ein Lakebase-Projekt löschen
Standardmäßig ist ein Lakebase-Projekt nach dem Löschen nicht mehr verfügbar und wird während der Aufbewahrungsdauer zur Wiederherstellung aufbewahrt. Das Löschen eines Lakebase-Projekts löscht die Workspace-Richtlinie nicht.
Löschen Sie das Beispiel des Lakebase-Projekts:
curl --fail-with-body -sS -X DELETE \ "$WORKSPACE/api/2.0/postgres/projects/policy-example" \ -H "Authorization: Bearer $DATABRICKS_TOKEN"Warten Sie, bis die zurückgegebene Operation abgeschlossen ist. Für Löschanforderungen, einschließlich geschützter Zweige, siehe Projekt löschen.
Verwalten von Richtlinien
Verwenden Sie die folgenden Vorgänge, um Richtlinien in Ihrem Arbeitsbereich zu überprüfen und zu pflegen.
Richtlinien abrufen und auflisten
Erhalten Sie eine individuelle Richtlinie mit GET /api/2.0/policies/compute/{compute_policy_id}, wie unter "Eine Richtlinie erstellen" dargestellt. Um Richtlinien aufzulisten, die Sie verwenden oder verwalten können, führen Sie folgendes aus:
curl --fail-with-body -sS "$WORKSPACE/api/2.0/policies/compute?page_size=100" \
-H "Authorization: Bearer $DATABRICKS_TOKEN"
Die Antwort enthält compute_policies und, wenn weitere Ergebnisse vorliegen, next_page_token. Gib diesen Token als page_token in der nächsten Anfrage. Die Standardseitengröße beträgt 100 und die maximale 150. Die Ergebnisse werden nicht sortiert. Jede Richtlinie enthält can_use und can_manage für die aufrufende Identität.
is_default Identifiziert eine Standardrichtlinie.
Eine Richtlinie aktualisieren
Richtlinienaktualisierungen erfordern einen update_mask-Abfrageparameter. Unterstützte Pfade sind display_name und allowed_compute_products. Um beide zu aktualisieren, trennen Sie die Pfade mit einem Komma. Dieser Endpunkt unterstützt das Aktualisieren von tags nicht.
Rufen Sie die Richtlinie ab und überprüfen Sie die Einstellungen, die Sie behalten möchten.
Senden Sie die geänderten Felder. Erhöhen Sie zum Beispiel die Kapazitätsgrenze der Beispielrichtlinie auf 32 CU und behalten Sie deren 15-minütiges Leerlauflimit:
curl --fail-with-body -sS -X PATCH \ "$WORKSPACE/api/2.0/policies/compute/$COMPUTE_POLICY_ID?update_mask=allowed_compute_products" \ -H "Authorization: Bearer $DATABRICKS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "allowed_compute_products": { "lakebase": { "max_capacity_units_per_instance": 32, "max_idle_minutes_before_scale_to_zero": 15 } } }'Überprüfen Sie die zurückgegebene Richtlinie, um das aktualisierte Limit zu überprüfen.
Das Aktualisieren des Objekts lakebase ersetzt seine Constraints. Fügen Sie jede Lakebase-Einschränkung hinzu, die Sie beibehalten möchten. Zum Beispiel entfernt das Weglassen einer bestehenden Leerlaufzeitlimite diese Begrenzung. Ein leeres lakebase Objekt hebt seine Begrenzungen auf, lässt aber weiterhin Lakebase zu. Verschachtelte Maskenpfade wie allowed_compute_products.lakebase.max_capacity_units_per_instance, werden nicht unterstützt.
Um eine Richtlinie umzubenennen, ohne ihre Einschränkungen zu ändern, verwenden Sie update_mask=display_name und einen Body wie {"display_name": "Lakebase application policy"}.
Die Senkung der Kapazitätsgrenze einer Richtlinie von 16 auf 8 CU lässt bestehende 16-CU-Rechenleistung unverändert. Jede spätere Kapazitätsänderung muss dem 8-CU-Limit entsprechen. Beim Wechsel zu einer anderen Richtlinie müssen vorhandene Compute-Ressourcen die Einschränkungen dieser Richtlinie erfüllen, bevor das Update abgeschlossen werden kann.
Löschen einer Richtlinie
Das Löschen einer Richtlinie löscht nicht die mit dieser Richtlinie erstellten Compute-Ressourcen. Die Durchsetzung ihrer Beschränkungen hängt davon ab, dass die Richtlinie weiterhin existiert und zugeordnet bleibt.
Bevor Sie eine benutzerdefinierte Richtlinie löschen:
-
Listen Sie Lakebase-Projekte auf, gemäß beliebigen
next_page_tokenWerten. Finden Sie Lakebase-Projekte, derenstatus.compute_policy_idmit der Richtlinie übereinstimmt, die Sie löschen möchten. - Bestätigen Sie, dass das Inventar alle betroffenen Lakebase-Projekte abdeckt.
CAN_MANAGEBei einer Richtlinie wird kein Zugriff auf jedes Lakebase-Projekt gewährt, das sie nutzt. Koordinieren Sie mit Lakebase-Projektverantwortlichen oder einem Workspace-Administrator für Projekte, die Sie nicht ansehen können. - Ersetzen Sie die Richtlinie für betroffene Lakebase-Projekte , bevor Sie sie löschen, sofern diese Projekte weiterhin durch eine Richtlinie geregelt werden müssen.
Um eine benutzerdefinierte Richtlinie zu löschen, führen Sie folgendes aus:
curl --fail-with-body -sS -X DELETE \
"$WORKSPACE/api/2.0/policies/compute/$COMPUTE_POLICY_ID" \
-H "Authorization: Bearer $DATABRICKS_TOKEN"
Die Standard-Lakebase-Richtlinie kann nicht gelöscht werden.
Troubleshooting
| Fehler oder Zustand | Aktivität |
|---|---|
PERMISSION_DENIED beim Erstellen eines Lakebase-Projekts |
Stellen Sie sicher, dass Sie CAN_USE oder CAN_MANAGE für eine Richtlinie haben, die Lakebase erlaubt. Wenn Sie die Richtlinien-ID weglassen, benötigen Sie Zugriff auf die Standard-Lakebase-Richtlinie. |
PERMISSION_DENIED beim Aktualisieren der Ressourcenkonfiguration |
Überprüfen Sie Ihre Berechtigung zur Verwaltung der Ressource. Änderungen an den von der Richtlinie geregelten Recheneinstellungen erfordern ebenfalls CAN_USE oder CAN_MANAGE für die Richtlinie, selbst wenn die Richtlinie keine Grenze für die Einstellung festlegt. Siehe Berechtigungen für Konfigurationsänderungen. |
PERMISSION_DENIED beim Ersetzen einer angehängten Richtlinie |
Überprüfen Sie Ihre Berechtigung zur Verwaltung der Ressource und CAN_USE /oder CAN_MANAGE sowohl bei der aktuellen Richtlinie als auch bei der Ersatzrichtlinie. |
BAD_REQUEST weil die Kapazität das Richtlinienmaximum überschreitet |
Reduzieren Sie autoscaling_limit_max_cu in der Endpunktkonfiguration oder die Compute-Standardwerte des Lakebase-Projekts, um das CU-Limit der Richtlinie zu erfüllen. |
BAD_REQUEST weil das Leerlauf-Timeout das Policy-Maximum überschreitet |
Aktivieren Sie die Skalierung auf null und wählen Sie ein Inaktivitäts-Timeout bis zum Richtlinienlimit auf einer Compute-Ressource, die Skalierung auf null unterstützt. |
INVALID_PARAMETER_VALUE beim Erstellen oder Aktualisieren einer Richtlinie |
Überprüfen Sie, dass der Name nicht leer ist und höchstens 127 Zeichen umfasst, mindestens ein Rechenprodukt vorhanden ist, Grenzwerte positive ganze Zahlen sind und die Update-Maske unterstützte Pfade enthält. Standard-Richtliniennamen und -konfigurationen können nicht geändert werden. |
ALREADY_EXISTS beim Benennen einer Richtlinie |
Wählen Sie einen anderen Namen aus. Standard-Richtliniennamen sind reserviert. |
Einschränkungen
Richtlinienverwaltung
- Richtlinien sind auf einen Arbeitsbereich beschränkt. Erstellen und gewähren Sie Zugriff auf Richtlinien in jedem Arbeitsbereich, in dem Sie diese verwenden.
- Die Standard-Lakebase-Richtlinie kann weder gelöscht noch ihr Name oder ihre Konfiguration geändert werden. Workspace-Administratoren können Berechtigungen dafür erteilen oder widerrufen.
- Das Entfernen einer Richtlinie aus einer Ressource erfordert einen Ersatz. Sie benötigen die Berechtigung, um die Ressource zu verwalten und
CAN_USEoderCAN_MANAGEfür beide Richtlinien auszuführen. Vorhandene Compute-Ressourcen müssen die Einschränkungen der Ersatzrichtlinie erfüllen, bevor das Update abgeschlossen werden kann. - Das Straffen einer Richtlinie ändert kein bestehendes Compute. Spätere Änderungen an geregelten Einstellungen müssen die aktualisierten Limits erfüllen.
- Das Löschen einer benutzerdefinierten Richtlinie löscht die mit dieser Richtlinie erstellten Compute-Ressourcen nicht. Die Durchsetzung der Beschränkungen dieser Richtlinie hängt von der fortbestehenden Existenz dieser Richtlinie ab.
- Die Policy-API gibt keine Tags in Get- oder Listenantworten zurück und unterstützt auch nicht, Tags über den Policy-Update-Endpunkt zu ändern.
Lakebase Compute
- Die Änderung der Rechenkapazität oder der Skalierungseinstellungen auf Null erfordert
CAN_MANAGEfür das Lakebase-Projekt undCAN_USEoderCAN_MANAGEfür dessen Richtlinie. Dies gilt auch dann, wenn die Richtlinie keine Grenze für die Einstellung setzt. - Scale to zero erfordert eine maximale Rechenkapazität von 32 CU oder kleiner. Wenn eine Richtlinie eine Leerlaufzeitbegrenzung verlangt, wählen Sie eine kompatible Rechengröße. Siehe Skalierung auf null konfigurieren.
- High Availability nutzt eine Rechengruppe mit mehreren Knoten und erfordert, dass Scale to Zero deaktiviert wird. Die Leerlaufzeitbegrenzung der Richtlinie gilt für diese Gruppen nicht. Kapazitätsbeschränkungen gelten weiterhin.
- Die Änderung der Rechenvorgaben eines Lakebase-Projekts betrifft neue Compute-Ressourcen. Aktualisieren Sie bestehende Rechenendpunkte separat, um deren Kapazität oder Idle-Timeout zu ändern.
Database Instances API-Kompatibilität
Die Database Instances API bleibt für bestehende Automatisierung verfügbar. Es verwendet Instanznamen und bereitgestellte Kapazitätsstufen und erstellt Lakebase-Projekte auf der Autoscaling-Plattform. Verwenden Sie die Postgres-API für neue Integrationen. Lakebase-Projekte, die über die Postgres-API oder die Lakebase-UI erstellt wurden, können nicht über die Database Instances API verwaltet werden. Siehe APIs.
Die Database Instances-API verwendet die Standard-Lakebase-Richtlinie. Das Erstellen eines Lakebase-Projekts über diese API erfordert CAN_USE oder CAN_MANAGE für diese Richtlinie. Lassen Sie compute_policy_id weg oder leer. Ein nicht leerer Wert wird sowohl bei Erstellen- als auch bei Aktualisierungsanfragen abgelehnt. Um eine benutzerdefinierte Richtlinie auszuwählen, verwenden Sie die Postgres-API.
Die Kompatibilitäts-API verwendet die folgenden Felder:
| Purpose | API-Feld Datenbankinstanzen |
|---|---|
| Überprüfen der angewendeten Richtlinie |
effective_compute_policy_id in der Instanzantwort. |
| Kapazität konfigurieren |
capacity, unter Verwendung einer provisionierten Stufe wie CU_1. Siehe das Tier-Mapping. |
| Wählen Sie eine Serverless-Nutzungsrichtlinie aus | Oberste Ebene usage_policy_id. Tags aus beiden Richtlinien gelten. |
Benutzer ohne Zugriff auf die Standardrichtlinie müssen die Postgres-API mit einer benutzerdefinierten Richtlinie verwenden, mit der sie ein Lakebase-Projekt erstellen können.