注意事項(xiàng)

• 源庫和目標(biāo)庫所屬的實(shí)例在同一地域下，且已加入數(shù)據(jù)共享。如何將實(shí)例加入數(shù)據(jù)共享，請參見開通或關(guān)閉數(shù)據(jù)共享。

• 目前僅支持表級別數(shù)據(jù)共享。

• 一個(gè)數(shù)據(jù)共享（Share）中最多可包含1000張表。

• 當(dāng)源實(shí)例中有多個(gè)Share時(shí)，目標(biāo)庫只能訂閱其中一個(gè)Share。

• 目標(biāo)庫無法對共享的表進(jìn)行寫操作。

• 共享的表無法進(jìn)行DDL操作，如果需要進(jìn)行DDL操作，需要取消該表的共享。如何取消表的共享，請參見移除表。

• AnalyticDB PostgreSQL版Serverless模式目前都默認(rèn)開通了索引功能，可以通過設(shè)置GUC參數(shù)的方式來強(qiáng)制寫入OSS。

創(chuàng)建Share

該語句用于在數(shù)據(jù)共享的源庫中創(chuàng)建Share。

CREATE DATASHARE <share_name>;

參數(shù)說明

share_name：需要創(chuàng)建的Share的名稱。長度為1~90個(gè)字符。

使用示例

CREATE DATASHARE s01;

刪除Share

該語句用于刪除數(shù)據(jù)庫中的Share。Share被刪除后，目標(biāo)庫將無法訪問共享的數(shù)據(jù)。

DROP DATASHARE <share_name>;

參數(shù)說明

share_name：需要刪除的Share的名稱。

使用示例

DROP DATASHARE s01;

Share授權(quán)

該語句用于授權(quán)目標(biāo)庫對源庫的Share的訂閱權(quán)限。目標(biāo)庫需要取得Share的權(quán)限后才能進(jìn)行訂閱操作。

GRANT USAGE ON DATASHARE <share_name> TO DATABASE <target_id>;

參數(shù)說明

• share_name：需要授權(quán)的Share的名稱。

• target_id：目標(biāo)庫的ID，格式為UUID形式。如何獲取數(shù)據(jù)庫的ID，請參見查詢數(shù)據(jù)庫ID。

使用示例

GRANT USAGE ON DATASHARE s01 TO DATABASE "c227516c-3802-4974-86e9-53**********";

回收Share權(quán)限

該語句用于回收目標(biāo)庫訂閱Share的權(quán)限。回收權(quán)限后，目標(biāo)庫將無法訪問共享的數(shù)據(jù)。

REVOKE USAGE ON DATASHARE <share_name> FROM DATABASE <target_id>;

參數(shù)說明

• share_name：需要回收的Share的名稱。

• target_id：目標(biāo)庫的ID，格式為UUID形式。如何獲取數(shù)據(jù)庫的ID，請參見查詢數(shù)據(jù)庫ID。

使用示例

REVOKE USAGE ON DATASHARE s01 FROM DATABASE "c227516c-3802-4974-86e9-53**********";

添加表

該語句用于將表添加到Share中。添加表后，即可在訂閱了該Share的目標(biāo)庫中查看該表。

ALTER DATASHARE <share_name> ADD TABLE <table_name>;

參數(shù)說明

• share_name：需要添加的Share的名稱。

• table_name：需要添加到Share中的表。

使用示例

ALTER DATASHARE s01 ADD TABLE t1_1;

移除表

該語句用于將表從Share中移除。

ALTER DATASHARE <share_name> REMOVE TABLE <table_name>;

參數(shù)說明

• share_name：需要移除的Share的名稱。

• table_name：需要從Share中移除的表。

使用示例

ALTER DATASHARE s01 REMOVE TABLE t1_1;

訂閱Share

該語句用于在目標(biāo)庫上訂閱源庫的Share。目標(biāo)庫要查詢共享的數(shù)據(jù)，需要取得源庫Share的授權(quán)并訂閱Share。

IMPORT DATASHARE <share_name> [AS <local_share_name>] FROM DATABASE <source_id>;

參數(shù)說明

• share_name：需要訂閱的Share的名稱。

• local_share_name：為訂閱的Share設(shè)置別名。

• source_id：源庫ID，為UUID形式。如何獲取數(shù)據(jù)庫的ID，請參見查詢數(shù)據(jù)庫ID。

使用示例

IMPORT DATASHARE s01 AS s01a FROM DATABASE "c227516c-3802-4974-86e9-53**********";

取消訂閱Share

該語句用于取消訂閱Share。取消訂閱后，目標(biāo)庫將無法訪問共享的數(shù)據(jù)。

DROP DATASHARE <share_name>;

參數(shù)說明

share_name：需要取消訂閱的Share的名稱。

使用示例

DROP DATASHARE s01;

查詢數(shù)據(jù)

該語句用于在目標(biāo)庫中查詢數(shù)據(jù)共享的數(shù)據(jù)。

SELECT * FROM <share_name.schema_name.table_name>;

參數(shù)說明

share_name.schema_name.table_name：目標(biāo)端查詢的共享表名字，需為三段式表示：

• share_name：Share的本地別名（若沒有設(shè)置別名可使用Share的名稱）。

• schema_name：共享表所在源庫的Schema的名稱。

• table_name：共享表的表名。

使用示例

SELECT * FROM s01.public.t1_1;

查詢數(shù)據(jù)庫ID

查詢數(shù)據(jù)庫的ID，ID為UUID格式。

SELECT current_database_uuid();