CREATE SCHEMA FROM SHARE
功能
CREATE SCHEMA FROM SHARE
语句用于使用被分享数据。该语句以schema为单位提取指定share对象中包含的数据对象,以便在数仓中对这些数据进行查询或处理。
语法
参数说明
new_schema_name: 基于share中的数据创建在本地数仓中的schema名称;注意该schema不可与工作空间中其他schema重名,且该schema创建后为只读schema,不可在其中创建其他数据对象。
instance_name.share_name: 被提取的share名称。因不同服务实例可能共享来同名的share对象,所以需要在share名称前加上instance名称以准确表达一个唯一的share对象。该信息可以通过具备实例管理员(instance_admin)或工作空间管理员(workspace_admin)角色的用户,执行show shares;
语句来获取。
schema_name: 指需要被提取的数据。提取数据是以schema为单位的,语句执行后new_schema_name中所包含的数据对象(table、view等)与share中schema_name下所包含的数据对象一致。所以这里需要填入要提取的share中的schema_name。
该信息可以通过具备实例管理员(instance_admin)或工作空间管理员(workspace_admin)角色的用户,执行desc share <instace_name>.<share_name>;
语句来获取。一个share对象中可能包含多个schema,使用需要提取的schema的名称。
示例
从服务实例y237xm2x 分享来的share_demo,提取其中sample_schema中的数据至当前工作空间中的schema:data_from_share_demo中。