メインコンテンツまでスキップ
に最終更新

パイプライン データセットでALTERステートメントを使用する

備考

プレビュー

この機能はパブリック プレビュー段階です。プレビュー登録は プレビュー ページで確認できます。「Databricks プレビューの管理」を参照してください。

LakeFlow Spark宣言型パイプライン (SDP) は、SDP に固有のソース コードでパイプラインを定義します。 パイプライン ソースはSQLまたはPython (たとえば、 LakeFlow Pipelines Editor)で編集できます。

Databricks は、 Databricks SQLと呼ばれる SQL 環境も提供します。SDP 外部のパイプライン機能を使用して、 Databricks SQLでマテリアライズドビューとストリーミング テーブルを作成できます ( Databricks SQLでのパイプラインの使用」を参照)。 通常、 Databricks SQL LakeFlow Spark宣言型パイプラインでは使用されません。

ただし、Databricks SQL のALTER SQL ステートメントを使用して、SDP または Databricks SQL で作成されたデータセットのプロパティを変更できます。SDP データセットを変更する場合でも、Databricks SQL パイプライン データセットを変更する場合でも、任意の Databricks SQL 環境からこれらの SQL ステートメントを使用できます。

注記

SDP で定義されたデータセットのスケジュールまたはトリガーをALTERステートメントで変更することはできません。

制限事項: パイプラインの更新と変更は ALTER​

ALTERステートメントがパイプラインで作成されたデータセットの定義と競合する場合があります。パイプライン内のテーブルまたはビューを定義する SQL は、更新ごとに再実行されます。これにより、 ALTERステートメントで行った変更を元に戻すことができます。

たとえば、次のようなマテリアライズドビューを定義するSQLステートメントがあるとします。

SQL
CREATE OR REPLACE MATERIALIZED VIEW masked_view (
    id int,
    name string,
    region string,
    ssn string MASK catalog.schema.ssn_mask_fn
  )
  WITH ROW FILTER catalog.schema.us_filter_fn ON (region)
  AS SELECT id, name, region, ssn
       FROM employees;

次に、次のように、 ALTERステートメントを使用してssn列からマスクを削除してみます。

SQL
ALTER MATERIALIZED VIEW masked_view ALTER COLUMN ssn DROP MASK;

マスクは削除されますが、次回マテリアライズドビューが更新されるときに、 SQL定義によってマスクが再び追加されます。

マスクを安全に削除するには、SQL 定義を編集してマスクを削除し、 ALTERコマンドを実行してマスクをDROPする必要があります。

注記

SDP で定義されたパイプラインの定義を編集するには、パイプライン エディターを使用してパイプライン ソースを編集します。Databricks SQL で定義されたパイプラインの定義を編集するには、任意の Databricks SQL 環境で変更された SQL ステートメントを実行します。

追加のリソース​