ALTER SHARE

[アーティクル]
11/07/2024

適用対象: check marked yes Databricks SQL Databricks Runtime 10.4 LTS 以上 Unity Catalog のみ

共有に対してスキーマ、テーブル、具体化されたビュー、またはビューを追加、変更、または削除します。共有の名前を変更します。共有の所有権を新しいプリンシパルに移します。

必要なアクセス許可:

共有所有者を更新するには、メタストア管理者、共有オブジェクトの所有者、または USE SHARE と SET SHARE PERMISSION の両方の特権を持つユーザーのいずれかである必要があります。
共有名を更新するには、メタストア管理者 (または CREATE_SHARE 特権を持つユーザー) であり、"同時に" 共有の所有者である必要があります。
テーブルまたはビューを追加するには、共有オブジェクトの所有者であり、テーブルまたはビューを含むスキーマに対する USE SCHEMA と、テーブルまたはビューに対する SELECT 権限を持っている必要があります。テーブルまたはビューの共有を希望する限り、SELECT 特権を維持する必要があります。
その他の共有プロパティを更新するには、所有者である必要があります。

構文

ALTER SHARE share_name
  { alter_add_materialized_view |
    REMOVE MATERIALIZED VIEW mat_view_name |
    alter_add_table |
    REMOVE TABLE table_name |
    alter_add_schema |
    REMOVE SCHEMA schema_name |
    alter_add_view |
    REMOVE VIEW view_name |
    alter_add_model |
    REMOVE MODEL model_name |
    RENAME TO to_share_name |
    [ SET ] OWNER TO principal }

alter_add_materialized_view
  { { ALTER | ADD } MATERIALIZED VIEW mat_view_name [ COMMENT comment ] [ AS mat_view_share_name ]

alter_add_table
  { { ALTER | ADD } [ TABLE ] table_name [ COMMENT comment ]
        [ PARTITION clause ] [ AS table_share_name ]
        [ WITH HISTORY | WITHOUT HISTORY ] }

alter_add_schema
  { { ALTER | ADD } SCHEMA schema_name [ COMMENT comment ]

alter_add_view
  { { ALTER | ADD } VIEW view_name [ COMMENT comment ] [ AS view_share_name ]

alter_add_model
  { { ALTER | ADD } VIEW model_name [ COMMENT comment ] [ AS model_share_name ]

Note

WITH HISTORY | WITHOUT HISTORY は Databricks Runtime 12.2 LTS 以降でサポートされています。 Databricks Runtime バージョン 11.1 から 12.0 まででは、WITH HISTORY ではなく WITH CHANGE DATA FEED [ START VERSION version ] ] を指定する必要があります。

WITH CHANGE DATA FEED は非推奨とされます。

タイムトラベルクエリとストリーミング読み取りに加えて、顧客が table_changes() 関数を使ってテーブルの変更データフィード (CDF) のクエリを実行できるようにする場合、WITH HISTORY (または WITH CHANGE DATA FEED) で共有する前に、テーブルで CDF を有効にする必要があることにもご注意ください。

パラメーター

share_name

変更する共有の名前。
alter_add_materialized_view

適用対象: Databricks SQL Databricks Runtime 13.3 LTS 以上

重要

この機能は、プライベートプレビュー段階にあります。これを試すには、Azure Databricks の連絡先に問い合わせてください。

共有に具体化されたビューを追加するか、既存の共有の具体化されたビューを変更します。このステートメントを実行するには、共有の所有者であり、具体化されたビューに対する SELECT 特権を持っている必要があります。
- ADD MATERIALIZED VIEW mat_view_name
  
  追加する具体化されたビューを指定します。具体化されたビューが見つからない場合、Azure Databricks で TABLE_OR_VIEW_NOT_FOUND エラーが発生します。
- ALTER MATERIALIZED VIEW mat_view_name
  
  変更する具体化されたビューを指定します。具体化されたビューがまだ共有の一部ではない場合、Azure Databricks でエラーが発生します。
- COMMENT comment
  
  具体化されたビュー共有にコメントとして添付されるオプションの STRING リテラル。
- AS mat_view_share_name
  
  オプションで、具体化されたビューを別の名前で公開します。この名前はスキーマ名で修飾できます。 mat_view_share_name が指定されていない場合、具体化されたビューはそれ自体の名前で認識されます。
  
  共有名が既に存在する場合、Azure Databricks にエラーが発生します。
- REMOVE MATERIALIZED VIEW mat_view_name
  
  適用対象: Databricks SQL Databricks Runtime 13.3 LTS 以上
  
  mat_view_name で指定された具体化されたビューを共有から削除します。このステートメントを実行するには、共有の所有者である必要があります。
- alter_add_table
  
  テーブルまたはテーブルのパーティションを共有に追加するか、既存の共有テーブルを変更します。このステートメントを実行するには、共有の所有者であり、テーブルに対する SELECT 特権を持っている必要があります。
  - ADD [ TABLE ] table_name
    
    追加するテーブルを識別します。テーブルは Unity Catalog に存在してはいけません。テーブルが見つからない場合、Azure Databricks で TABLE_OR_VIEW_NOT_FOUND エラーが発生します。
  - ALTER [ TABLE ] table_name
    
    変更するテーブルを指定します。テーブルがまだ共有の一部ではない場合、Azure Databricks でエラーが発生します。
  - COMMENT comment
    
    テーブル共有にコメントとして添付されるオプションの STRING リテラル。
  - PARTITION 句
    
    追加するテーブルの 1 つまたは複数のパーティション。パーティションキーは、テーブルのパーティション分割と一致し、値に関連付けられている必要があります。 PARTITION clause が存在しない場合は、ADD TABLE によってテーブル全体が追加されます。
    
    受信者のプロパティを参照してパーティション分割するには、次の構文を使用します。
```
PARTITION (column_name = CURRENT_RECIPIENT().<property-key>)
```
    受信者のプロパティを参照したパーティション分割 適用対象: Databricks SQL Databricks Runtime 12.2 LTS 以上。
  - AS table_share_name
    
    必要に応じて、テーブルを別の名前で公開します。この名前はデータベース (スキーマ) 名で修飾できます。 table_share_name が指定されていない場合、テーブルはそれ自体の名前で認識されます。
  - WITH HISTORY または WITHOUT HISTORY
    
    適用対象: Databricks SQL Databricks Runtime 12.2 LTS 以降。
    
    WITH HISTORY が指定されている場合、完全な履歴を含むテーブルを共有して、受信者がタイムトラベルクエリを実行できるようにします。共有テーブルは、VERSION AS OF と TIMESTAMP AS OF を使用して参照できます。
    
    タイムトラベルクエリとストリーミング読み取りに加えて、顧客が table_changes() 関数を使ってテーブルの変更データフィード (CDF) のクエリを実行できるようにする場合は、WITH HISTORY で共有する前に、テーブルで CDF を有効にする必要があります。
    
    既定の動作は WITHOUT HISTORY です。
- REMOVE TABLE table_name
  
  table_name によって識別されるテーブルを共有から削除します。このステートメントを実行するには、共有の所有者である必要があります。
- alter_add_schema
  
  適用対象: Databricks SQL Databricks Runtime 13.3 LTS 以上
  
  共有にスキーマを追加する、または既存の共有スキーマを変更します。このステートメントを実行するには、共有とスキーマの所有者である必要があります。
  - ADD SCHEMA schema_name
    
    追加するスキーマを指定します。スキーマが見つからない場合、Azure Databricks では SCHEMA_NOT_FOUND エラーが生じます。
  - ALTER SCHEMA schema_name
    
    変更するスキーマを指定します。スキーマがまだ共有の一部ではない場合、Azure Databricks でエラーが発生します。
  - COMMENT comment
    
    スキーマ共有にコメントとして添付されるオプションの STRING リテラル。
- REMOVE SCHEMA schema_name
  
  schema_name で指定されたスキーマを共有から削除します。このステートメントを実行するには、共有の所有者である必要があります。
- alter_add_view
  
  適用対象: Databricks SQL Databricks Runtime 13.3 LTS 以上
  
  共有にビューを追加する、または既存の共有ビューを変更します。このステートメントを実行するには、共有の所有者であり、ビューに対して SELECT 特権を持っている必要があります。
  - ADD VIEW view_name
    
    追加するビューを指定します。ビューが見つからない場合、Azure Databricks では TABLE_OR_VIEW_NOT_FOUND エラーが生じます。
  - ALTER VIEW view_name
    
    変更するビューを指定します。ビューがまだ共有の一部ではない場合、Azure Databricks でエラーが発生します。
  - COMMENT comment
    
    ビュー共有にコメントとして添付されるオプションの STRING リテラル。
  - AS view_share_name
    
    オプションで、ビューを別の名前で公開します。この名前はスキーマ名で修飾できます。 view_share_name が指定されていない場合、ビューはそれ自体の名前で認識されます。
    
    共有名が既に存在する場合、Azure Databricks にエラーが発生します。
- REMOVE VIEW view_name
  
  view_name で指定されたビューを共有から削除します。このステートメントを実行するには、共有の所有者である必要があります。
- alter_add_model
  
  適用対象: Databricks SQL Databricks Runtime 14.0 以上
  
  共有にモデルを追加するか、または既存の共有モデルを変更します。このステートメントを実行するには、共有の所有者であり、モデルに対する EXECUTE 特権を持っている必要があります。
  - ADD MODEL model_name
    
    追加するモデルを指定します。モデルが見つからない場合は、Azure Databricks で RESOURCE_DOES_NOT_EXIST エラーが発生します。
  - ALTER MODEL model_name
    
    変更するモデルを指定します。モデルがまだ共有に含まれない場合は、Azure Databricks でエラーが発生します。
  - COMMENT comment
    
    モデル共有にコメントとして添付されるオプションの STRING リテラル。
  - AS model_share_name
    
    必要に応じて、別の名前でモデルを公開します。この名前はスキーマ名で修飾できます。 model_share_name を指定しないと、モデルはそれ自体の名前で認識されます。
    
    共有名が既に存在する場合、Azure Databricks にエラーが発生します。
- REMOVE MODEL model_name
  
  model_name で指定されたモデルを共有から削除します。このステートメントを実行するには、共有の所有者である必要があります。
- RENAME TO to_share_name
  
  適用対象: Databricks SQL Databricks Runtime 11.3 LTS 以上
  
  共有の名前を変更します。名前は、メタストア内のすべての共有で一意にする必要があります。このステートメントを実行するには、共有の所有者であり、メタストアに対する CREATE SHARE 特権を持っている必要があります。
- [ SET ] OWNER TO principal
  
  共有の所有権を principal に転送します。このステートメントを実行するには、共有の所有者である必要があります。
  
  適用対象: Databricks SQL Databricks Runtime 11.3 LTS 以上
  
  SET は省略可能なキーワードとして使用できます。

例

-- Creates a share named `some_share`.
> CREATE SHARE some_share;

-- Add a table to the share.
> ALTER SHARE some_share
     ADD TABLE my_schema.my_tab
         COMMENT 'some comment'
         PARTITION(c1_int = 5, c2_date LIKE '2021%')
         AS shared_schema.shared_tab;

-- Add a schema to the share.
> ALTER SHARE some_share
     ADD SCHEMA some_schema
         COMMENT 'some comment';

-- Add a view to the share.
> ALTER SHARE some_share
     ADD VIEW my_schema.my_view
         COMMENT 'some comment'
         AS shared_schema.shared_view;

-- Add a materialized view to the share.
> ALTER SHARE some_share
     ADD MATERIALIZED VIEW my_schema.my_mat_view
         COMMENT 'some comment'
         AS shared_schema.shared_mat_view;

-- Share a table with history
> ALTER SHARE share ADD TABLE table1 WITH HISTORY;
> ALTER SHARE share ADD TABLE table2 WITHOUT HISTORY;
> SHOW ALL IN SHARE share;
  Name    type   ... history_sharing  ...
  ------  ------ ... ----------------
  Table1  TABLE  ... ENABLED          ...
  Table2  TABLE  ... DISABLED         ...

-- Remove the table again
> ALTER SHARE some_share
    REMOVE TABLE shared_schema.shared_tab;

-- Remove the schema again
> ALTER SHARE some_share
    REMOVE SCHEMA some_schema;

-- Remove a view again
> ALTER SHARE some_share
    REMOVE VIEW shared_schema.shared_view;

-- Rename a share
> ALTER SHARE some_share
    RENAME TO new_share;

-- Change ownership of the share
> ALTER SHARE some_share
    OWNER TO `alf@melmak.et`

次の方法で共有

構文

パラメーター

例

フィードバック

その他のリソース

次の方法で共有

構文

パラメーター

例

関連記事

フィードバック

その他のリソース