DatabricksワークスペースをUnity Catalogにアップグレードする

このページでは、Unity Catalogを使用していないワークスペースをUnity Catalogにアップグレードする方法の概要を説明します。また、従来のHive metastore 、 DBFS 、およびサポート対象外のDatabricks Runtimeバージョンからの移行手順も記載されています。

アップグレード手順の概要

Unity Catalog にアップグレードするには、次のことを行う必要があります。

プロビジョニング ID (ユーザー、グループ、サービスプリンシパル) を Databricks アカウントに直接行います (まだ行っていない場合)。ワークスペースレベルの ID プロビジョニングをオフにします。
ワークスペースローカルグループをアカウントレベルのグループに変換します。Unity Catalog は、アカウントレベルで ID 管理を一元化します。
ワークスペースを Unity Catalog メタストアにアタッチします。ワークスペースリージョンにメタストアが存在しない場合は、アカウント管理者がメタストアを作成する必要があります。
Hive metastore で管理されているテーブルとビューを Unity Catalogにアップグレードします。
アカウントレベルのユーザー、グループ、またはサービスプリンシパルに、アップグレードされたテーブルへのアクセス権を付与します。
クエリとジョブを更新して、古いHive metastore テーブルではなく新しいUnity Catalog テーブルを参照します。
DBFSからファイル、ノートブック、スクリプトを移行します。
アクティブなコンピュートリソースを、サポートされているDatabricks Runtimeバージョンにアップグレードします。
ワークスペース内の旧機能へのアクセスを無効にします。ワークスペースでレガシー機能へのアクセスを無効にする方法については、こちらをご覧ください。

要件

開始する前に、メタストアや管理ストレージなど、Unity Catalog の基本的な概念について理解しておく必要があります。「Unity Catalog とは」を参照してください。

また、次の要件を満たしていることも確認する必要があります。

ほとんどのセットアップ手順では、Databricks アカウント管理者である必要があります。その後のタスクで他のアクセス許可要件がある場合は、タスク固有のドキュメントに記載されています。

Unity Catalog デモへのアップグレード

次の短いガイド付きデモを見て、主要なアップグレードタスクの動作を確認してください。各デモでは、特定の手順と、該当する場合は詳細なドキュメントへのリンクが記載されています。

ワークスペースローカルグループをアカウントレベルグループに変換する
Hive metastoreのテーブルをUnity Catalogテーブルにアップグレードする
コンピュートを更新して Unity Catalog
- 汎用コンピューティング
- SQLウェアハウス
アップグレードされたテーブルで動作するようにクエリとジョブを更新する

または、デモ「 UCX を使用して Unity Catalog にアップグレードする」に従うこともできます。

アカウントへのユーザー、グループ、サービスプリンシパルのプロビジョン

Unity Catalog はアカウントレベルの ID を参照します。メタストアをワークスペースにアタッチする前に、次の操作を行う必要があります。

IdP からワークスペースまでプロビジョニングユーザー、グループ、およびサービスプリンシパルにSCIM使用している場合は、SCIM をオフにして、代わりにDatabricksアカウントにプロビジョニングを設定します。「ID プロバイダーからの ID の同期」および「ID」を参照してください。
ユーザー、グループ、サービスプリンシパルを管理するように構成されたオートメーション ( SCIM プロビジョニングコネクタや Terraform オートメーションなど) を更新して、ワークスペースエンドポイントではなくアカウントエンドポイントを参照するようにします。アカウントレベルおよびワークスペースレベルの SCIM プロビジョニングを参照してください。

ワークスペースローカルグループをアカウントレベルのグループに変換する

ワークスペースローカルグループをアカウントグループに移行するを参照してください。

ワークスペースをメタストアにアタッチする

ワークスペースで Unity Catalog が有効になっていない (メタストアに接続されている) 場合、次の手順は、ワークスペースリージョンに Unity Catalog メタストアが既に定義されているかどうかによって異なります。

アカウントにワークスペースリージョンに対して Unity Catalog メタストアが既に定義されている場合は、ワークスペースを既存のメタストアに簡単にアタッチできます。Unity Catalog のワークスペースを有効にするに移動します。
ワークスペースのリージョンに Unity Catalog メタストアが定義されていない場合は、メタストアを作成してから、ワークスペースをアタッチする必要があります。Unity Catalog メタストアを作成するに移動します。

Hive metastore内のテーブルをUnity Catalogテーブルにアップグレード

ワークスペースが Unity Catalogで有効になる前にサービスに含まれていた場合、ワークスペースには、引き続き使用するデータが含まれている可能性が高い Hive metastore があります。 Databricks では、 Hive metastore によって管理されているテーブルを Unity Catalog メタストアにアップグレードすることをお勧めします。

オプション 1: フェデレートしてからフォーリンテーブルをアップグレードする

推奨されるアプローチは、最初にHive metastoreフォーリンカタログとしてフェデレーションし、次にフォーリンテーブルを適切にアップグレードすることです。この 2 段階のプロセスにより、テーブルの履歴、構成、権限、ビューを保持しながら、データを移動せずにテーブルを移行できます。

まず、 Hive metastoreをUnity Catalogのフォーリンカタログとして統合します。これによりUnity Catalogを通じて既存のテーブルにアクセスし、アップグレードの準備をすることができます。

Hive metastore統合する手順については、 Hive metastore統合: Unity Catalogを有効にしてHive metastoreに登録されたテーブルを管理できるようにする」を参照してください。

注記

テーブルをアップグレードせず、フェデレーションカタログを永続的に使用し続けることを選択した場合は、そうすることができます。ただし、Databricks では、Unity Catalog の機能を最大限に活用するためにアップグレードを完了することをお勧めします。

Hive metastoreをフェデレーションした後、データを移動せずにフォーリンテーブルをUnity Catalogテーブルにアップグレードできます。このワークフローは、テーブルの履歴、構成、権限、およびビューを保持しながら、テーブルをその場でアップグレードします。

Databricks では、Unity Catalog の予測的最適化を利用するためにマネージドテーブルへのアップグレードを推奨しています。これには、自動メンテナンス（コンパクション、クラスタリング、vacuum）とパフォーマンスの向上が含まれます。フォーリンテーブルを Unity Catalog マネージドテーブルにアップグレードするには、MOVE を指定して次のコマンドを実行します。これにより、テーブルがその場で変換され、外部カタログ内のソーステーブルへのアクセスが無効になります：

SQL
ALTER TABLE <foreign_catalog>.<schema>.<table_name> SET MANAGED MOVE;

あるいは、フォーリンテーブルをUnity Catalogの外部テーブルにアップグレードするには、次のコマンドを実行します。

SQL
ALTER TABLE <foreign_catalog>.<schema>.<table_name> SET EXTERNAL;

テーブルの移行が完了し、外部カタログへのフェデレーションに依存しなくなった場合は、フォーリンカタログへの接続を削除できます。

SQL
ALTER CATALOG <foreign_catalog> DROP CONNECTION;

このワークフローの詳細については、「SQL を使用したフォーリンテーブル」を参照してください。

オプション2: テーブルを直接アップグレードする

フェデレーションベースのアップグレードワークフローを使用しない場合は、 SYNCまたはCREATE TABLE AS SELECTを使用してテーブルを直接アップグレードできます。「Hive テーブルとビューを Unity Catalog にアップグレードする」を参照してください。

アップグレードされたテーブルまたはフェデレーテッドテーブルへのアクセスの許可

アカウントレベルのユーザー、グループ、またはサービスプリンシパルに、新しいテーブルへのアクセス権を付与します。Unity Catalog での特権の管理を参照してください。

アップグレードされたテーブルとデータへのパスを操作するためのクエリとジョブの更新

ワークスペースローカルHive metastoreからUnity Catalogに移行している間も、Hive metastoreに登録されているデータを参照するクエリとジョブを引き続き使用できます。 Hive metastoreフェデレーション(推奨) またはUnity Catalogと併用したレガシHive metastore システムの操作で説明されている構文を使用します。ただし、最終的には、Unity Catalog のテーブルと構文を使用するようにすべてのクエリとジョブを更新する必要があります。

同様に、ファイルへのパスベースのアクセスを使用するクエリとジョブを更新して、代わりに Unity Catalog ボリュームを使用します。

詳細な推奨事項については、「従来のワークスペースを Unity Catalog にアップグレードするときにジョブを更新する」を参照してください。

DBFSへのアクセスを無効にする

Unity Catalog移行の一環として、 Databricksワークスペース内のDBFSへのアクセスを無効にすることをお勧めします。これにより、すべてのデータとがUnity Catalogによって管理され、 Unity Catalog機能を最大限に活用できるようになります。

Databricks Labs のDBFSスキャナスクリプトを使用して、現在のDBFS使用状況をスキャンし、資産を所定の場所に登録するか (外部ロケーションを使用)、 Unity Catalogに移行するか、不要になった場合はアーカイブするかを決定できます。 Databricks Labs は、 Databricksによって直接サポートされていないパブリックGitHubリポジトリです。

以下のセクションでは、 DBFSからUnity Catalogへさまざまなアセットを移行する方法について説明します。

DBFSに保存されているファイルを移行する

Parquet 、 CSV 、 JSON 、イメージなどの生ファイルがDBFSルート (たとえば、 /FileStoreまたは他のDBFSルートディレクトリの下) またはDBFSにマウントされたクラウドストレージ ( /mnt/...の下) に保存されている場合は、 Unity Catalogボリュームを使用してそれらのファイルを移行し、外部ロケーションを使用してアクセスします。

以下は、 DBFSからUnity Catalogボリュームにファイルを移行する方法について説明します。ボリュームとワークスペースファイルを使用する場合の詳細については、「ボリューム内のファイルとワークスペースファイルの推奨事項」を参照してください。

外部ロケーションのセットアップ

Unity Catalogにアセットを登録するには、ファイルが現在存在するクラウドストレージコンテナまたはパスのUnity Catalog外部ロケーションを設定します。これを行うには、カタログエクスプローラー、 SQLコマンド、 Terraform 、またはDatabricks CLIを使用します。

詳細な手順については、「Unity Catalog を使用してクラウドオブジェクトストレージに接続する」を参照してください。

ボリュームを作成

Unity Catalogボリュームは、ファイルを整理するための体系的な方法を提供する。 Databricksは、すべての非表形式データを管理するためにボリュームを使用することを推奨しています。外部ロケーションのサブパスを参照するスキーマ内に外部ボリュームを作成できます。例えば：

SQL
USE CATALOG main;
USE SCHEMA data;
CREATE EXTERNAL VOLUME IF NOT EXISTS raw_files
LOCATION 'my_data_loc/csv-files/';

そのパスの下にあるすべてのファイルは、外部ロケーションを通じてアクセスできるようになり、 Unity Catalog権限によって管理されるようになります。

詳細については、 Unity Catalogボリュームとは？」を参照してください。

DBFSルートからファイルをコピー

ファイルが以前DBFSルートに保存されていた場合は、クラウドストレージのパスにコピーしてください。例えば、ノートブックでは：

Python
dbutils.fs.cp(
  "dbfs:/FileStore/tables/data.csv",
  "/Volumes/main/data/raw_files/data.csv"
)

ヒント

If you have a large number of files or files larger than a few GB, consider using the Databricks CLI or a distributed copy using Apache Spark to parallelize the move. The Databricks CLI fs cp command can recursively copy directories.

移行されたファイルを確認する

移行後、標準コマンドを使用してボリュームからファイルを一覧表示および読み取ります。

Python
# List files in the volume
dbutils.fs.ls("/Volumes/main/data/raw_files/")

# Read a CSV file into a DataFrame
df = spark.read.option("header", True).csv(
  "/Volumes/main/data/raw_files/2024-01-01-data.csv"
)

このコードには、ボリュームまたは外部ロケーションに対する適切なUnity Catalog権限と、 Unity Catalogサポートするコンピュートリソースが必要です。 Unity Catalog は、ファイルを読み取るプリンシパルがボリュームまたは外部ロケーションに対してREAD権限を持っていることを強制します。

DBFSマウントのクリーンアップ

新しい場所にあるファイルにアクセスできることを確認したら、混乱や誤使用を防ぐため、古いDBFSマウントポイントをアンマウントしてください。

Python
dbutils.fs.unmount("/mnt/oldpath")

DBFSルートのデータが移動された場合は、そのデータをロックダウンまたは削除することを検討してください。コピーを残しておくと、更新の不整合やセキュリティリスクにつながる可能性があります。

DBFSからワークスペースアセットを移行する

一部のワークスペースには、ノートブック、コードファイル、または参照スクリプトがDBFSに保存されています。これらには以下が含まれる可能性があります。

ノートブックは共有用に/FileStoreにHTMLまたはDBCファイルとして保存されます。
Databricksジョブで使用されるPythonスクリプトまたはJARファイル
コンピュートスコープの init スクリプト (例: dbfs:/databricks/init/... )

ノートブックとコードは、DBFSではなく、ワークスペースファイルまたはGitフォルダに保存する必要があります。DBFSはファイルごとのアクセス制御を提供しないため、ソースコードやノートブックには使用しないでください。

ノートブック : DBFS上にファイルとしてノートブックがある場合は、それらをDatabricksワークスペースにインポートします。これは、UIのインポート機能を使用するか、CLIを使用して手動で行うことができます。ワークスペース内のノートブックのアクセス許可が、チームアクセス用に適切に設定されていることを確認してください。今後は、ノートブックをワークスペースオブジェクトまたはGitフォルダに保存し、バージョン管理にはGitを使用してください。
ジョブスクリプト : DBFSからPythonスクリプトを実行するようにジョブが構成されている場合 (たとえば、タスクタイプがdbfs:/mnt/scripts/my_etl.pyを参照する「 Pythonスクリプト」のジョブ)、それらのスクリプトをワークスペースファイルに移動します。バージョン管理と変更履歴の追跡のために、それらをGitフォルダで管理してください。
アーティファクトとライブラリのビルド : JARファイルやPythonホイールなどのアセットは、 Unity Catalogボリュームに保存する必要があります。
コンピュートスコープの init スクリプト : コンピュートスコープの init スクリプトはUnity Catalogボリュームに保存する必要があります。「init スクリプトとは何ですか?」を参照してください。。

コンピュートを見つけて、サポートされているDatabricks Runtimeバージョンとアクセスモードに移行する

注記

このセクションには、 system.compute.clustersテーブルにアクセスするクエリが含まれています。このシステムテーブルにアクセスするには、 Databricksアカウント管理者であるか、 computeシステムスキーマに対するUSEおよびSELECT権限を付与されている必要があります。システムテーブルへのアクセス権の付与を参照してください。

Unity Catalog移行の一環として、 DatabricksすべてのコンピュートとジョブをDatabricks Runtime 13.3 LTS以降にアップグレードし、 Unity Catalogアクセスモードを使用することをお勧めします。

ワークスペースのコンピュートを手動で確認するには、ワークスペースの コンピュート ページに移動します。 [汎用コンピュート] セクションで、各コンピュートのDatabricks Runtimeバージョンを確認します。バージョンで並べ替えまたはフィルタリングして、バージョン13.3 LTSより前のバージョンを実行しているクラスターを特定します。特定のDatabricks Runtimeバージョンを使用するようにジョブを構成することもできるため、 ジョブのコンピュート セクションでもこの手順を繰り返します。

13.3 LTSより前のバージョンを実行しているコンピュートをプログラムで検索するには、 system.compute.clustersテーブルをクエリします。例えば：

SQL
SELECT
  workspace_id,
  cluster_id,
  dbr_version
FROM system.compute.clusters
WHERE
  TRY_CAST(SPLIT(dbr_version, '\\.')[0] AS INT) < 13
  OR (
    TRY_CAST(SPLIT(dbr_version, '\\.')[0] AS INT) = 13
    AND TRY_CAST(SPLIT(dbr_version, '\\.')[1] AS INT) < 3
  );

これにより、13.3 LTSより前のバージョンを実行している汎用コンピュートおよびジョブコンピュートリソースのリストが返されます。

コンピュートをサポートされているアクセスモードにアップグレードする

まだ非分離共有アクセスモードでコンピュートを実行している場合は、サポートされているアクセスモードにアップグレードできます。アクセスモードを参照してください。非分離共有アクセスモードで実行されているコンピュートをクエリするには、 system.compute.clustersテーブルをクエリします。例えば：

SQL
SELECT
  workspace_id,
  cluster_id,
  dbr_version,
  data_security_mode
FROM system.compute.clusters
WHERE data_security_mode IN ('NONE','NO_ISOLATION')
LIMIT 100;

ワークスペースでレガシー機能へのアクセスを無効にする

上記の移行ステップを完了したら、ワークスペースの従来の機能へのアクセスを無効にすることができます。

DBFSルートとマウントを無効にする : DBFSルートまたはマウントに依存するすべてのデータとワークフローを移行し、すべてのジョブとクラスターをDatabricks Runtime 13.3 LTS以降にアップグレードしたら、ワークスペース管理者は既存のワークスペースでDBFS無効にできます。 DBFSルートへのアクセスを無効にし、既存のDatabricksワークスペースにマウントする」を参照してください。
Hive metastoreを無効にする : Unity Catalog移行を完了するか、 Hive metastoreをUnity Catalogによって管理されるフォーリンカタログとしてフェデレーションすると、ワークスペース管理者は、ユーザーがUnity CatalogバイパスしてHive metastoreに登録されたテーブルにアクセスするのを防ぐことができます。 Databricksワークスペースで使用されるHive metastoreへのアクセスを無効にする」を参照してください。
分離なし共有コンピュートリソースを無効にする : ユーザーが新しい分離なし共有コンピュートリソースを作成できないようにするには、ワークスペース管理者がワークスペース内で分離なし共有コンピュートリソースを無効にします。アカウントで分離なし共有クラスターの管理者保護を有効にするを参照してください。

アップグレード手順の概要​

要件​

Unity Catalog デモへのアップグレード​

アカウントへのユーザー、グループ、サービスプリンシパルのプロビジョン​

ワークスペースローカルグループをアカウントレベルのグループに変換する​

ワークスペースをメタストアにアタッチする​

Hive metastore内のテーブルをUnity Catalogテーブルにアップグレード​

オプション 1: フェデレートしてからフォーリンテーブルをアップグレードする​

オプション2: テーブルを直接アップグレードする​

アップグレードされたテーブルまたはフェデレーテッドテーブルへのアクセスの許可​

アップグレードされたテーブルとデータへのパスを操作するためのクエリとジョブの更新​

DBFSへのアクセスを無効にする​

DBFSに保存されているファイルを移行する​

外部ロケーションのセットアップ​

ボリュームを作成​

DBFSルートからファイルをコピー​

移行されたファイルを確認する​

DBFSマウントのクリーンアップ​

DBFSからワークスペースアセットを移行する​

コンピュートを見つけて、サポートされているDatabricks Runtimeバージョンとアクセス モードに移行する​

コンピュートをサポートされているアクセス モードにアップグレードする​

ワークスペースでレガシー機能へのアクセスを無効にする​