サーバーレス計算ポリシーを管理する

サーバーレス計算ポリシーにより、ワークスペース管理者はサポートされているサーバーレス計算製品へのアクセスを制御し、設定を制限し、新しく作成された計算リソースにタグを強制できます。 このページでは、ポリシーの作成方法、アクセス権の付与、およびそれらを Lakebase で使用する方法について説明します。

Important

サーバーレスのコンピュートポリシーはプライベートプレビューにあり、REST APIを通じて管理されます。 プレビューは Lakebase をサポートしています。 アクセスを要求するには、Databricks アカウント チームに問い合わせてください。

Requirements

  • ワークスペースはサーバーレスコンピュートポリシープレビューに登録されており、Lakebaseにアクセスできる必要があります。 Lakebaseリージョンの利用可能性については、「 リージョンの可用性 」をご覧ください。
  • ポリシーを作成するにはワークスペース管理者である必要があります。 既存のポリシーを読んだり利用したりするには、そのポリシーについて CAN_USE または CAN_MANAGE が必要です。 カスタムポリシーを更新または削除したり、ポリシーの権限を管理するには、 CAN_MANAGEが必要です。
  • 例では curl、 jq、およびワークスペース OAuth トークンを使用します。 認証の例では Databricks CLI を使用しています。

サーバーレス計算ポリシーの仕組み

サーバーレスのコンピュートポリシーはワークスペースに属します。 その allowed_compute_products オブジェクトは、ユーザーがポリシーを通じて使用できる計算製品と、各製品の構成の制限を指定します。 ポリシーを通じてアクセスを許可し、ユーザーがその制限内で許可された製品を使用できるようにします。

作成後、添付されたポリシーはポリシーが存在する間、コンピュートの設定変更を管理します。 ポリシーを厳格化しても既存のコンピュートは変更されません。 ポリシーによって管理される設定へのその後の更新は、その現在の制約を満たす必要があります。 例えば、Lakebase の容量変更は、ポリシーの現在の最大値(計算単位(CU)で測定)内に収まらなければなりません。

クラシック計算を管理するポリシーについては、「 クラシック計算ポリシーの作成と管理」を参照してください。

構成変更のための権限

リソースの設定を更新したり、そのコンピュートポリシーを置き換えたりするには、以下の権限が必要です:

構成の変更 必要なアクセス許可
ポリシーの範囲外の設定を変更する リソースを管理する権限。 ポリシーを使用するための許可は必要ありません。
ポリシーで管理される計算設定を変更する リソースを管理し、ポリシーに対して CAN_USE または CAN_MANAGE を行う権限(その設定に制限が設定されていない場合でも)。
アタッチされたポリシーを置き換える リソースと CAN_USE または CAN_MANAGE を管理するための、現在のポリシーとその置き換えポリシーの両方に対する権限。

リソースを管理する権限は製品によって異なります。 例えば、Lakebase プロジェクトに CAN_MANAGE があるユーザーは、そのコンピュートポリシーにアクセスできなくても表示名を変更できます。 計算容量の変更やゼロへのスケール設定を変更するには、ポリシーに容量制限やアイドル時間の制限が設定されていなくても、そのポリシーを使用する許可が必要です。

ポリシーの使用許可は、その制約を回避するものではありません。 更新された設定はポリシーの制限を満たし、必要なタグキー値ペアを保持する必要があります。

代替を割り当てずにリソースからポリシーを削除することはできません。 Lakebaseプロジェクトの場合、交換ポリシーはLakebaseを許可している必要があります。 spec.compute_policy_idのクリアは、Default Lakebase Policy を代替として割り当て、同じ権限が必要です。

ポリシータグ

オプションのトップレベル tags マップを使用して、 display_name と allowed_compute_productsと並べてキー値タグを指定します。 タグ キーと値は文字列です。 ポリシーは最大20個のタグを持ち、各キーは空でなければなりません。

サーバーレスのコンピュートポリシーからのタグは、そのポリシーで作成されたコンピュートに伝播します。 ポリシーは、ポリシーが存在し、そのまま関連付けられている間、これらのタグを強制します。 コンピュートのタグの変更は、添付されたポリシーで必要なキー-値ペアを保持しなければなりません。

サーバーレス使用ポリシー(サーバーレス予算ポリシーとも呼ばれる)は、コスト帰属用のタグを割り当て、別のポリシーIDを使用します。 サーバーレス使用ポリシーはサーバーレスコンピュートポリシーと併用できます。 作成されたコンピュートは、両方のポリシーのタグの和集合を受け取ります。 例えば、コンピュートポリシーが environment=development を指定し、使用ポリシーが cost_center=engineeringを指定した場合、コンピュートは両方のタグを受け取ります。

Lakebase ポリシー設定

サーバーレス計算ポリシーを通じて Lakebase を許可するには、lakebase に allowed_compute_products を含めてください。

Lakebaseプロジェクトの作成

Lakebase プロジェクトを作成するには、Lakebase を許可するポリシーの CAN_USE または CAN_MANAGE が必要です。 Lakebase プロジェクトを作成すると、自動的にそのプロジェクトに CAN_MANAGE が付与されます。

ポリシー権限は既存の Lakebase プロジェクトやそのデータへのアクセスを許可しません。 Lakebase プロジェクト権限は リソース管理を制御し、ポリシーによって管理される計算設定を変更するには 追加のポリシー権限 が必要です。 Postgres のロールと権限付与は、データベースへのアクセスを制御します。

容量とアイドル時間の制限

allowed_compute_products.lakebaseの下に、次のいずれかまたは両方のフィールドを設定します:

フィールド Description
max_capacity_units_per_instance Lakebase CUの最大容量。 オートスケーリング計算の場合、設定された最大値はこの制限内に収まらなければなりません。
max_idle_minutes_before_scale_to_zero コンピュートがゼロにスケールするまでの最大非アクティブタイムアウト(分単位)。 この制限の対象となるコンピュートは、スケール・トゥ・ゼロが有効で、タイムアウトは制限以下でなければなりません。

どちらのフィールドも正の整数を受け入れます。 フィールドを省略しても、その設定に対するポリシー制限は設定されません。 空の lakebase オブジェクトは、Lakebaseをいずれの制限も適用せずに許可します。 Lakebaseを許可するにはポリシーに lakebase オブジェクトが含まれている必要があります。

例えば、以下の lakebase オブジェクトは各計算を16 CUに制限し、最大15分間の非アクティブ後はスケールをゼロにする必要があります:

{
  "max_capacity_units_per_instance": 16,
  "max_idle_minutes_before_scale_to_zero": 15
}

これらの制限は、サポートされる コンピューティング サイズ および ゼロへのスケーリング設定を補完します。 ポリシーはサポートされていない構成を利用可能にしません。 「ゼロへのスケールを使えない構成の 制限 」を参照してください。

デフォルトの Lakebase ポリシー

ワークスペースのデフォルト Lakebase ポリシーにより、容量やアイドル時間の制限なしに Lakebase を使用できます。 ワークスペースユーザーは、このポリシーを使用してデフォルトでLakebaseプロジェクトを作成できます。

ワークスペース管理者は、Permissions API を通じて Default Lakebase ポリシーに対する権限を付与または取り消すことができます。 彼らはポリシーを削除したり、その名前や設定を変更したりすることはできません。

Compute Policy を指定せずに Lakebase プロジェクトを作成する場合、リクエストは Default Lakebase ポリシーを使用します。 そのポリシーを使用するには許可が必要です。 カスタムポリシーを作成しても、デフォルトポリシーへのアクセスを取り消したり、既存の Lakebase プロジェクトにカスタムポリシーを自動的に適用したりすることはありません。 ユーザーにカスタムポリシーの選択を求めるには、「 Lakebase プロジェクト作成にカスタムポリシーを必須とする」を参照してください。

API認証を設定する

これらのリクエストにはワークスペースのURLとワークスペースのOAuthトークンを使用してください。 認証の詳細については、「OAuth を使用して Azure Databricks へのユーザー アクセスを承認」を参照してください。

  1. WORKSPACE を末尾のスラッシュを付けずにワークスペースの URL に設定します。

    export WORKSPACE="https://<workspace-host>"
    
  2. そのワークスペースにサインインする:

    databricks auth login --host "$WORKSPACE"
    
  3. 認証済みIDのOAuthトークンを取得する:

    export DATABRICKS_TOKEN="$(databricks auth token --host "$WORKSPACE" | jq -r .access_token)"
    

トークンが期限切れの場合は更新してください。 各リクエストを必要な権限を持つIDとして実行します。

ポリシーを作成する

次の例は、Lakebase を許可するサーバーレス計算ポリシーを作成します:

  1. ワークスペース管理者として、次のリクエストを送信してください。 最大 16 CU、最大非アクティブタイムアウト時間 15 分、そして強制 environment=development タグを持つポリシーを作成します。

    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"
        }
      }'
    
  2. レスポンスから compute_policy_id をコピーし、その後のリクエスト用に設定します:

    export COMPUTE_POLICY_ID="<compute-policy-id>"
    
  3. ポリシーを取得して、その名称と製品の制約を確認します。 この回答にはポリシーのタグが含まれていません:

    curl --fail-with-body -sS "$WORKSPACE/api/2.0/policies/compute/$COMPUTE_POLICY_ID" \
      -H "Authorization: Bearer $DATABRICKS_TOKEN"
    

リクエストボディはポリシーオブジェクトそのものです。 サービスは compute_policy_idを割り当てます。 ワークスペース内で1文字から127文字までのユニークな表示名を選択します。

ポリシーへのアクセスを許可する

オブジェクト タイプで compute-policy を使用します。 ポリシー作成者はCAN_MANAGEを持っています。

  1. CAN_MANAGE を持つアイデンティティとして、既存のワークスペースグループにポリシーを使用する権限を付与します。 lakebase-developersをグループ名に置き換えてください:

    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"
          }
        ]
      }'
    
  2. 許可の確認:

    curl --fail-with-body -sS \
      "$WORKSPACE/api/2.0/permissions/compute-policy/$COMPUTE_POLICY_ID" \
      -H "Authorization: Bearer $DATABRICKS_TOKEN"
    

user_nameを使用してユーザーにアクセスを許可するか、サービスプリンシパルのアプリケーションIDでservice_principal_nameします。 プリンシパルにポリシーを使用し、その権限を管理するための CAN_MANAGE を付与します。 カスタムポリシーの場合、CAN_MANAGE では、設定の更新やポリシーの削除も行えます。 PATCH 指定されたグラントを更新します。 PUT は直接の権限割り当てを置き換えるため、保持したい権限一式をすべて含めてください。

Lakebaseプロジェクト作成にカスタムポリシーを必須にする

ワークスペース管理者として、ユーザーにカスタムポリシーの選択を求めるには、以下の手順を使用してください:

  1. next_page_tokenし、 の値に従います。 lakebaseで、is_default 値と allowed_compute_products エントリによってデフォルトの Lakebase ポリシーを見つけます。 それをcompute_policy_idにコピーします。
  2. 影響を受けるユーザーまたはグループに、Lakebase を許可するカスタムポリシーへのアクセスを付与します。
  3. 既定のポリシーを使用している既存の Lakebase プロジェクトでは、ユーザーがガバナンスされたコンピュート設定の変更を続ける必要がある場合は 、そのポリシーを置き換え てください。 デフォルト ポリシーへのアクセスを取り消すと、そのポリシーをまだ使用しているコンピュートでは、それらの変更を行えなくなります。
  4. GET /api/2.0/permissions/compute-policy/<default-policy-id>で既定ポリシーの権限を取得します。 ユーザーとグループへの付与を確認します。 既定のポリシーは最初に users グループへのアクセスを許可するため、直接ユーザー付与を削除してもそのユーザーのアクセスは削除されません。
  5. PUT /api/2.0/permissions/compute-policy/<default-policy-id>をに置き換えます。 access_control_listで保持したい直接の助成金を含め、影響を受けるユーザーにアクセス権を与えるものは省略してください。 一部のユーザーがデフォルトポリシーアクセスを保持すべき場合は、広範な users グラントを特定のグループへのグラントに置き換えます。 各リクエストエントリは、付与例のようにプリンシパル名と permission_levelを使用します。 パーミッション GET 応答をそのまま PUT ボディとして送信しないでください。
  6. 影響を受けるユーザーとして、ポリシーをもう一度一覧表示してください。 カスタムポリシーが利用可能で、デフォルトポリシーがもう利用できていないことを確認してください。 Lakebase プロジェクトを作成する際には、ユーザーがカスタムポリシー ID を指定する必要があります。

Lakebase プロジェクトでポリシーを使用する

Postgres API(/api/2.0/postgres/)を使用して Lakebase プロジェクトを作成および管理します。 Lakebase プロジェクトにはブランチが含まれ、コンピュートエンドポイントはそれらのブランチに対してコンピュートを提供します。 「コンピュートとエンドポイント」を参照してください。

Lakebase プロジェクトを作成する際に、spec.compute_policy_id付きのコンピュートポリシーを選択します。 添付されたポリシーはコンピュート構成を制御し、関連付けられたコンピュートに必要なタグを適用します。 ポリシー管理は別個の /api/2.0/policies/compute APIを使用します。

ポリシーを使った Lakebase プロジェクトを作成する

上記で作成したポリシーで、CAN_USE または CAN_MANAGE を持つ ID を使用する:

  1. 2〜8 CU のオートスケーリング範囲と 15 分間の非アクティブタイムアウトを持つ Lakebase プロジェクトを作成します:

    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"
          }
        }
      }')"
    

    容量の値の単位は Lakebase CU です。 最大8 CUは、そのポリシーの16 CUの上限を満たします。 Lakebaseは非アクティブタイムアウトを秒単位の時間として表しています。 "900s" はポリシーの15分の制限に相当します。 これらのデフォルトは初期コンピュートを構成し、Lakebase プロジェクト内の新しいコンピュートの開始設定を提供します。

    サーバーレス使用ポリシーも適用するには、spec内に"budget_policy_id": "<usage-policy-id>"を追加し、使用できるポリシーのIDを使いましょう。 Computeは両方のポリシーからタグを受け取ります。

  2. レスポンスから操作 name をコピーし、ステータス要求に対して設定します:

    export OPERATION_NAME="<operation-name>"
    
  3. doneがtrueされるまでオペレーションを取得します:

    curl --fail-with-body -sS "$WORKSPACE/api/2.0/postgres/$OPERATION_NAME" \
      -H "Authorization: Bearer $DATABRICKS_TOKEN"
    

    応答に errorが含まれている場合は、続行する前に解決してください。 リクエストの作成、更新、削除はこの 長期実行の操作パターンを使用します。

Lakebaseプロジェクトの閲覧および一覧表示

  1. Lakebaseプロジェクトを取得する:

    curl --fail-with-body -sS "$WORKSPACE/api/2.0/postgres/projects/policy-example" \
      -H "Authorization: Bearer $DATABRICKS_TOKEN"
    
  2. 選択したポリシーに一致する status.compute_policy_id を確認してください。

  3. アクセス可能な Lakebase プロジェクトを一覧にしてください:

    curl --fail-with-body -sS "$WORKSPACE/api/2.0/postgres/projects" \
      -H "Authorization: Bearer $DATABRICKS_TOKEN"
    

リスト応答に next_page_tokenが含まれている場合は、その値を page_token として渡して次のページを取得します。

Lakebase プロジェクトの更新

Lakebase プロジェクトに対する CAN_MANAGE を持つ ID を使用します。 表示名を変更する場合、そのコンピュートポリシーを使用するための権限は必要ありません。

  1. Lakebase プロジェクトの表示名を更新し、更新マスク内のフィールドを指定します:

    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"}}'
    
  2. 返された操作が完了するまで待ってから、Lakebase プロジェクトを取得して変更を確認します。

Lakebase プロジェクトのキャパシティやスケール・トゥ・ゼロ 計算のデフォルト を変更するには、設定に制限がなくてもポリシーの CAN_USE または CAN_MANAGE が必要です。 新しい値は、適用されるポリシーの制限をすべて満たさなければなりません。 デフォルトは新しいコンピュートが作成された際に適用されます。 既存のコンピュートを変更するには、以下の手順に従ってそのエンドポイントを更新します。

添付したポリシーを変更するには、「 Lakebase プロジェクトのポリシーを置き換える」を参照してください。

Lakebase compute を更新

次の例では、既存のコンピュートの最大 CU を 16 CU に引き上げ、非アクティブタイムアウトを 10 分に短縮します。 Lakebaseプロジェクトに対する CAN_MANAGE と、ポリシーに対する CAN_USE または CAN_MANAGE 権限が必要です:

  1. Lakebase プロジェクトの production ブランチ上のエンドポイントを一覧にしてください:

    curl --fail-with-body -sS \
      "$WORKSPACE/api/2.0/postgres/projects/policy-example/branches/production/endpoints" \
      -H "Authorization: Bearer $DATABRICKS_TOKEN"
    
  2. 応答から最初の compute のエンドポイント name をコピーします。 名前には Lakebase プロジェクト、ブランチ、およびエンドポイントパスが含まれます:

    export ENDPOINT_NAME="<endpoint-name>"
    
  3. 最大CUおよびゼロへのスケーリング設定を更新します。 非アクティブタイムアウトの更新マスクで spec.suspension を使用します:

    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"
        }
      }'
    
  4. 返された操作が完了するまで待ってから、エンドポイントを取得します。

    curl --fail-with-body -sS "$WORKSPACE/api/2.0/postgres/$ENDPOINT_NAME" \
      -H "Authorization: Bearer $DATABRICKS_TOKEN"
    

    status.autoscaling_limit_max_cuとstatus.suspend_timeout_durationを確認してください。

更新された最大値はポリシーの16 CUの上限に合致しており、"600s" は15分間のアイドル時間制限を下回っています。 この計算では、16 CU を超えるリクエスト、15 分を超える非アクティブタイムアウト、またはゼロへのスケール設定を無効にすると、ポリシーの検証が失敗します。 ポリシーの制限内で設定を選択するか、ポリシーマネージャーに確認を依頼してください。

Lakebase プロジェクトのポリシーを置き換える

Lakebaseプロジェクトには CAN_MANAGE が必要で、現行ポリシーとその置換ポリシーの両方には CAN_USE または CAN_MANAGE が必要です。 代替ポリシーはLakebaseを許可しなければなりません。

ポリシーの切り替えは構成更新です。 更新が完了する前に、Lakebase プロジェクトの既存の compute および compute デフォルトが、置き換えポリシーの制約を満たす必要があります。

  1. 交換ポリシーを選択し、そのIDを設定します:

    export REPLACEMENT_COMPUTE_POLICY_ID="<replacement-policy-id>"
    
  2. Lakebase プロジェクトの コンピュートのデフォルト設定 と既存のコンピュートが、置換ポリシーの容量およびアイドル時間の制限を満たしていることを確認してください。 既存のコンピュートを更新 し、必要に応じてデフォルトを調整します。

  3. Lakebase プロジェクトのポリシー割り当てを更新してください:

    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
        }
      }')"
    
  4. 返されたオペレーションがdone: trueで終了するのを待ってください。 error の項目が含まれている場合は、続行する前に解決してください。

  5. Lakebase プロジェクトを取得し、 status.compute_policy_id が置換ポリシー ID に一致していることを確認します。

    curl --fail-with-body -sS "$WORKSPACE/api/2.0/postgres/projects/policy-example" \
      -H "Authorization: Bearer $DATABRICKS_TOKEN"
    

spec.compute_policy_idをクリアするとデフォルト Lakebase ポリシーが選択され、使用には許可が必要です。 これによりレイクベースプロジェクトがポリシーなしの状態になるわけではありません。

Lakebase プロジェクトを削除する

デフォルトでは、Lakebase プロジェクトを削除するとそのプロジェクトは利用できなくなり、保持期間中は リカバリー のために保持されます。 Lakebase プロジェクトを削除しても、ワークスペースポリシーは削除されません。

  1. 例の Lakebase プロジェクトを削除する:

    curl --fail-with-body -sS -X DELETE \
      "$WORKSPACE/api/2.0/postgres/projects/policy-example" \
      -H "Authorization: Bearer $DATABRICKS_TOKEN"
    
  2. 返されたオペレーションが完了するまでお待ちください。 削除要件(保護されたブランチを含む)については、「 プロジェクトの削除」を参照してください。

ポリシーの管理

ワークスペース内のポリシーを点検および維持するには、以下の操作を使用してください。

ポリシーの取得およびリスト

を使用して個別のポリシーを取得します。これは GET /api/2.0/policies/compute/{compute_policy_id} に示すとおりです。 使用または管理できるポリシーを一覧表示するには、以下を実行します:

curl --fail-with-body -sS "$WORKSPACE/api/2.0/policies/compute?page_size=100" \
  -H "Authorization: Bearer $DATABRICKS_TOKEN"

回答には compute_policies が含まれており、さらに結果がある場合は next_page_token も含まれます。 次のリクエストでそのトークンを page_token として渡してください。 デフォルトのページサイズは100で、最大は150です。 結果はソートされていません。 各ポリシーには呼び出し元 ID の can_use と can_manage が含まれています。 is_default デフォルトポリシーを特定します。

ポリシーの更新

ポリシー更新には update_mask クエリパラメーターが必要です。 サポートされているパスは display_name と allowed_compute_productsです。 両方を更新するには、パスをカンマで区切ってください。 このエンドポイントは tagsの更新をサポートしていません。

  1. ポリシーを取得し、保持したい設定を確認します。

  2. 変更されたフィールドを送信します。 例えば、例のポリシーの容量制限を32 CUに引き上げ、15分のアイドル時間制限を維持します。

    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
          }
        }
      }'
    
  3. 返されたポリシーを確認して、更新された制限を確認してください。

lakebaseオブジェクトを更新すると、その制約が置き換えられます。 保持したいすべての Lakebase 制約を含めてください。 例えば、既存のアイドル時間制限を省略すると、その制限は解除されます。 空の lakebase オブジェクトは、Lakebaseを引き続き許可しつつ、制限を解除します。 allowed_compute_products.lakebase.max_capacity_units_per_instanceのような入れ子状マスクパスはサポートされていません。

制約を変更しずにポリシーの名前を変更するには、 update_mask=display_name と {"display_name": "Lakebase application policy"} などのボディを使用します。

ポリシーの容量制限を16 CUから8 CUに下げても、既存の16-CU計算は変更されません。 その後の容量変更は8-CUの制限に準拠しなければなりません。 別のポリシーに切り替える際、更新が完了する前に既存のコンピュートがそのポリシーの制約を満たす必要があります。

ポリシーを削除する

ポリシーを削除しても、そのポリシーを使用して作成されたコンピュート リソースは削除されません。 その制約の執行は、そのポリシーが存続し、アタッチされたままであるかどうかに依存しています。

カスタムポリシーを削除する前に:

  1. next_page_tokenし、任意の値に従ってください。 削除予定のポリシーに一致する status.compute_policy_id を持つ Lakebase プロジェクトを探します。
  2. インベントリが影響を受けるすべてのLakebaseプロジェクトを網羅していることを確認してください。 CAN_MANAGE はポリシーで、そのポリシーを使用するすべての Lakebase プロジェクトへのアクセス権が付与されるわけではありません。 表示できないプロジェクトについては、Lakebase プロジェクトオーナーやワークスペース管理者と連携してください。
  3. 影響を受ける Lakebase プロジェクトについては 、ポリシーの管理を継続する必要がある場合は削除前にポリシーを置き換えてください。

カスタムポリシーを削除するには、次を実行します:

curl --fail-with-body -sS -X DELETE \
  "$WORKSPACE/api/2.0/policies/compute/$COMPUTE_POLICY_ID" \
  -H "Authorization: Bearer $DATABRICKS_TOKEN"

デフォルト Lakebase ポリシーは削除できません。

Troubleshooting

エラーまたは条件 アクション
PERMISSION_DENIED Lakebase プロジェクトを作成する際 Lakebase を許可するポリシーに対して、CAN_USE または CAN_MANAGE の権限があることを確認してください。 ポリシー ID を省略した場合、デフォルト Lakebase ポリシーへのアクセスが必要です。
PERMISSION_DENIED リソース構成を更新する際 リソースを管理する権限を確認してください。 ポリシーによって管理されるコンピューティング設定の変更には、ポリシーに対する CAN_USE または CAN_MANAGE の権限も必要です。ポリシーでその設定に制限が設けられていない場合でも同様です。 構成変更の権限を参照してください。
PERMISSION_DENIED 添付されたポリシーを置き換える場合 現在のポリシーおよびその置き換えのポリシーの両方で、リソースおよび CAN_USE または CAN_MANAGE を管理する権限を確認してください。
BAD_REQUEST 容量がポリシーで許可される最大値を超えているため エンドポイント構成や Lakebase プロジェクトの計算デフォルトで、autoscaling_limit_max_cu を含む設定をポリシーの CU 制限に合わせて削減してください。
BAD_REQUEST アイドルタイムアウトがポリシーの最大値を超えているため ゼロへのスケールを有効にし、スケーリング・トゥ・ゼロをサポートする計算でポリシー制限以下の非アクティブタイムアウトを選択します。
INVALID_PARAMETER_VALUE ポリシーを作成または更新する際 名前が非空白で、最大127文字であること、少なくとも1つの計算産物が存在すること、制限値が正の整数であること、更新マスクにサポートされているパスが含まれていることを確認してください。 デフォルトのポリシー名および構成は変更できません。
ALREADY_EXISTS ポリシーに名前を付ける際 別の名前を選択してください。 デフォルトのポリシー名は予約されています。

制限事項

ポリシー管理

  • ポリシーはワークスペースに限定されます。 使用する各ワークスペースでポリシーを作成し、ポリシーへのアクセス権を付与します。
  • デフォルト Lakebase ポリシーは削除できず、名前や設定を変更することもできません。 ワークスペース管理者は、その対象に対する権限を付与または取り消すことができます。
  • リソースからポリシーを削除するには、代替ポリシーが必要です。 リソースを管理する権限と、両方のポリシーで CAN_USE または CAN_MANAGE を行う権限が必要です。 更新が完了する前に、既存のコンピュートが置換ポリシーの制約を満たす必要があります。
  • ポリシーを厳格化しても既存のコンピュートは変更されません。 その後のガバナンス設定の変更は、更新された制限を満たす必要があります。
  • カスタム ポリシーを削除しても、そのポリシーを使用して作成されたコンピュートは削除されません。 そのポリシーの制約の適用は、そのポリシーの存続に依存します。
  • ポリシー API は、get 回答やリスト応答でタグを返すことはできず、ポリシー更新エンドポイントを通じたタグ変更をサポートしません。

Lakebase コンピュート

  • 計算容量やスケール・トゥ・ゼロ設定を変更するには、Lakebase プロジェクトで CAN_MANAGE を持ち、そのポリシーで CAN_USE または CAN_MANAGE を持っている必要があります。 これは、ポリシーが設定に制限を設けていない場合でも適用されます。
  • ゼロにスケールするには、最大計算サイズが32 CU以下である必要があります。 ポリシーにアイドル時間制限が必要な場合は、互換性のある計算サイズを選択してください。 「 スケールをゼロに設定する」を参照してください。
  • 高可用性 は複数のノードを持つコンピュートグループを使用し、ゼロへのスケールを無効にする必要があります。 ポリシーのアイドルタイム制限はこれらのグループには適用されません。 容量制限は依然として適用されます。
  • Lakebase プロジェクトの計算デフォルトを変更すると、新しいコンピュートに影響します。 既存のコンピュートエンドポイントを個別に更新し、容量やアイドルタイムアウトを変更します。

データベースインスタンスAPI互換性

データベースインスタンスAPIは既存のオートメーションでも引き続き利用可能です。 インスタンス名とプロビジョニング容量階層を使用し、Autoscaling プラットフォーム上で Lakebase プロジェクトを作成します。 新しい統合には Postgres API を使用してください。 Postgres API または Lakebase UI で作成された Lakebase プロジェクトは、Database Instances API では管理できません。 API を参照してください。

データベースインスタンスAPIはデフォルトのLakebaseポリシーを使用します。 このAPIを通じてLakebaseプロジェクトを作成するには、そのポリシーの CAN_USE または CAN_MANAGE が必要です。 compute_policy_idを省略するか、空にしておきましょう。 非空の値は、作成および更新の両方のリクエストで拒否されます。 カスタムポリシーを選択するには、 Postgres API を使用してください。

互換性APIは以下のフィールドを使用します:

Purpose データベースインスタンスAPIフィールド
適用されたポリシーを確認する effective_compute_policy_id インスタンス応答内。
容量を設定する capacity、CU_1 のようなプロビジョニング階層を使用します。 ティアマッピングをご覧ください。
サーバーレス使用ポリシーを選択してください トップレベルの usage_policy_id。 両方のポリシーのタグが適用されます。

デフォルトポリシーにアクセスできないユーザーは、Lakebase プロジェクトを作成する際に使用できるカスタムポリシーを Postgres API で使用する必要があります。

追加リソース