メインコンテンツまでスキップ

シークレット管理

Databricks シークレットは、パスワード、APIキー、ハッシュソルトなどの機密値を格納するため、ノートブック、ジョブ、関数は、その値がコードに表示されることなく値を使用できます。シークレットは、以下の2つの場所で管理できます。

  • ワークスペースSecret Scope :単一のワークスペースにあるシークレットの名前付きコレクション。権限はスコープ全体に適用されます。「ワークスペースSecret Scope」を参照してください。
  • Unity Catalog のシークレット :メタストアにアタッチされたすべてのワークスペースで利用可能なセキュリティ保護可能なオブジェクト(catalog.schema.secret)。各シークレットへのアクセスを許可できます。Unity Catalog のシークレットを参照してください。

Unity Catalog のシークレットは、Databricks が管理することも、AWS Secrets Manager でバックアップすることもできます。「Unity Catalog の AWS Secrets Manager シークレット」を参照してください。

シークレットの格納先を選択します​

次の表は、各オプションがシークレット値をどこに保存するか、どのワークスペースがそれらを使用できるか、およびアクセスをどのように制御するかを比較したものです。

ワークスペースSecret Scope

Unity Catalog の Databricks 管理シークレット

Unity CatalogにおけるAWS Secrets Managerバックアップのシークレット(ベータ)

値の格納場所

Databricks(ワークスペース内)

Databricks (Unity Catalog 内)

AWS Secrets Manager (Databricks は Unity Catalog にシークレット名のみを保存します)

独自のキーによる暗号化

はい。マネージドサービスのための顧客管理キーがあります。

はい、カタログの顧客管理キーを使用します

-

利用可能

1つのワークスペース

メタストアにアタッチされたすべてのワークスペース

メタストアにアタッチされたすべてのワークスペース

アクセス制御

Secret scopeの権限(シークレットレベルのアクセス制御なし)

シークレット、スキーマ、またはカタログに対する Unity Catalog 権限

シークレット、スキーマ、またはカタログに対する Unity Catalog 権限

ローテーションする

Databricksの値を更新

Databricksの値を更新

AWS Secrets Manager でローテーションします。Databricks に変更はありません。

ワークスペースSecret Scope

Unity Catalog の Databricks 管理シークレット

Unity CatalogにおけるAWS Secrets Managerバックアップのシークレット(ベータ)

値の格納場所

Databricks(ワークスペース内)

Databricks (Unity Catalog 内)

AWS Secrets Manager (Databricks は Unity Catalog にシークレット名のみを保存します)

独自のキーによる暗号化

はい。マネージドサービスのための顧客管理キーがあります。

はい、カタログの顧客管理キーを使用します

-

利用可能

1つのワークスペース

メタストアにアタッチされたすべてのワークスペース

メタストアにアタッチされたすべてのワークスペース

アクセス制御

Secret scopeの権限(シークレットレベルのアクセス制御なし)

シークレット、スキーマ、またはカタログに対する Unity Catalog 権限

シークレット、スキーマ、またはカタログに対する Unity Catalog 権限

ローテーションする

Databricksの値を更新

Databricksの値を更新

AWS Secrets Manager でローテーションします。Databricks に変更はありません。

シークレットを使用できる場所​

ワークスペースSecret ScopeとUnity Catalogシークレットは、異なる場所でサポートされています。いずれかを選択する前に、コードをランする場所で機能することを確認してください。

表面

ワークスペースSecret Scope

Unity Catalogのシークレット

dbutils.secrets ノートブックおよびジョブ内

はい。シークレットを読み取るを参照してください。

はい、Serverless環境バージョン4以上、またはDatabricks Runtime 17.3 LTS以上で可能です。「シークレットを読み取る」を参照してください。

REST API と Databricks CLI

はい。APIによって返される値は編集されません。

はい。APIによって返される値は編集されません。

Databricks Connectなどのリモート開発

はい。Databricks Connectクライアントのdbutils.secretsを使用します。「Databricks Connect for PythonでDatabricksユーティリティを使用する」を参照してください。

No

Unity Catalog Python および Scala UDF

No

はい。呼び出し側は EXECUTE のみが必要です。UDF でシークレットを使用するを参照してください。

SQLウェアハウス

はい、secret関数を使用します

シークレットを宣言する Unity Catalog Python または Scala UDF を介してのみ

コンピュート上のSpark構成プロパティと環境変数

はい。「Spark 構成プロパティまたは環境変数でのシークレットの使用」を参照してください。

No

モデルサービングEndpoint環境変数

はい。シークレットベースの環境変数の追加を参照してください。

No

デフォルトパッケージリポジトリ

はい。databricks-package-managementスコープ内です。「defaultのパッケージリポジトリの構成」を参照してください。

No

表面

ワークスペースSecret Scope

Unity Catalogのシークレット

dbutils.secrets ノートブックおよびジョブ内

はい。シークレットを読み取るを参照してください。

はい、Serverless環境バージョン4以上、またはDatabricks Runtime 17.3 LTS以上で可能です。「シークレットを読み取る」を参照してください。

REST API と Databricks CLI

はい。APIによって返される値は編集されません。

はい。APIによって返される値は編集されません。

Databricks Connectなどのリモート開発

はい。Databricks Connectクライアントのdbutils.secretsを使用します。「Databricks Connect for PythonでDatabricksユーティリティを使用する」を参照してください。

No

Unity Catalog Python および Scala UDF

No

はい。呼び出し側は EXECUTE のみが必要です。UDF でシークレットを使用するを参照してください。

SQLウェアハウス

はい、secret関数を使用します

シークレットを宣言する Unity Catalog Python または Scala UDF を介してのみ

コンピュート上のSpark構成プロパティと環境変数

はい。「Spark 構成プロパティまたは環境変数でのシークレットの使用」を参照してください。

No

モデルサービングEndpoint環境変数

はい。シークレットベースの環境変数の追加を参照してください。

No

デフォルトパッケージリポジトリ

はい。databricks-package-managementスコープ内です。「defaultのパッケージリポジトリの構成」を参照してください。

No

その他のリソース​