统一目录CLI(遗留)

重要的

这个文档已经退休了,可能不会被更新。

这个信息适用于遗留数据砖CLI版本0.17及以下。砖建议你使用新砖CLI的版本0.200或更高版本。看到砖CLI。找到你的版本的砖CLI,运行- v

从砖CLI或低于0.17版本迁移到砖CLI版本0.200或更高版本,看看砖CLI的迁移

请注意

统一目录CLI实验

统一目录CLI要求砖CLI(遗留)0.17.0以上,配置了身份验证。更新数据砖CLI或列出安装的版本,看更新CLI

选择和现场抽样值只在下面的例子进行说明。

使用统一编目CLI使用:

  • 统一目录资源,如metastores存储凭证、外部位置、目录、模式、表和他们的权限。

  • 三角洲分享资源,如股票、接受者和提供者。

你运行统一目录CLI子命令通过添加unity-catalog。这些子命令调用统一目录API,其中还包括三角洲共享API。

显示使用文档,运行unity-catalog——帮助

输出:

用法:砖unity-catalog[选项]命令(ARGS)……效用与砖统一的目录。选项:- v,版本0.17.1 - h,帮助显示此消息并退出。命令:目录external-locations血统metastores权限提供者模式股票storage-credentials表接受者

Metastores

使用unity-catalogmetastores子命令处理metastores

显示使用文档,运行unity-catalogmetastores——帮助

创建一个metastore

显示使用文档,运行unity-catalogmetastores创建——帮助。另请参阅创建一个目录metastore统一

砖unity-catalog metastores my-metastore创建——名称\——地区us-west-2\——贮藏根s3: / /桶/ abcdefghij

如果你不指定地区,metastore创建在当前工作区中。

输出:

{“名称”:“my-metastore”,“storage_root”:“s3: / /桶/ abcdefghij / 12 a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656112029354,“created_by”:“someone@example.com”,“updated_at”:1656112029354,“updated_by”:“someone@example.com”,“delta_sharing_enabled”:,“所有者”:“someone@example.com”,“地区”:“us-west-2”,“云”:“aws”,“global_metastore_id”:“aws:美国-西方- 2:12a345b6 - 7890 - 1 - cd2 - 3456 e789f0a12b34”,“delta_sharing_scope”:“内部”,“privilege_model_version”:“0.1”}

请注意

创建一个metastore并不会自动关联metastore工作区或存储凭证。为了完成这些任务,明白了链接一个metastore工作区,创建一个存储凭证,更新一个metastore的设置

更新一个metastore的设置

显示使用文档,运行unity-catalogmetastores更新——帮助

砖unity-catalog metastores更新——id 12 a345b6张cd - 7890 - 1 - 3456 e789f0a12b34\——json文件update-metastore.json

metastore ID,运行unity-catalogmetastores得到概要。例如,看到的总结当前metastore信息

update-metastore.json:

{“storage_root_credential_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”}

根证书存储ID,明白了得到信息存储凭证

输出:

{“名称”:“my-metastore”,“storage_root”:“s3: / /桶/ abcdefghij / 12 a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“default_data_access_config_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656365260817,“created_by”:“someone@example.com”,“updated_at”:1656366434069,“updated_by”:“someone@example.com”,“delta_sharing_enabled”:真正的,“所有者”:“someone@example.com”,“delta_sharing_recipient_token_lifetime_in_seconds”:86400年,“地区”:“us-west-2”,“storage_root_credential_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“云”:“aws”,“global_metastore_id”:“aws:美国-西方- 2:12a345b6 - 7890 - 1 - cd2 - 3456 e789f0a12b34”,“delta_sharing_scope”:“INTERNAL_AND_EXTERNAL”,“privilege_model_version”:“0.1”}

列出可用metastores

显示使用文档,运行unity-catalogmetastores列表——帮助

砖unity-catalog metastores列表

输出:

{“metastores”:({“名称”:“my-metastore”,“storage_root”:“s3: / /桶/ abcdefghij / 12 a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“default_data_access_config_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656365260817,“created_by”:“someone@example.com”,“updated_at”:1656366434069,“updated_by”:“someone@example.com”,“delta_sharing_enabled”:真正的,“所有者”:“someone@example.com”,“delta_sharing_recipient_token_lifetime_in_seconds”:86400年,“地区”:“us-west-2”,“storage_root_credential_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“云”:“aws”,“global_metastore_id”:“aws:美国-西方- 2:12a345b6 - 7890 - 1 - cd2 - 3456 e789f0a12b34”,“delta_sharing_scope”:“INTERNAL_AND_EXTERNAL”,“privilege_model_version”:“0.1”},{“…”:“…”}]}

得到metastore信息

显示使用文档,运行unity-catalogmetastores得到——帮助

砖unity-catalog metastores得到- id 12 a345b6张cd - 7890 - 1 - 3456 e789f0a12b34

metastore ID,运行unity-catalogmetastores得到概要。例如,看到的总结当前metastore信息

输出:

{“名称”:“my-metastore”,“storage_root”:“s3: / /桶/ abcdefghij / 12 a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“default_data_access_config_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656365260817,“created_by”:“someone@example.com”,“updated_at”:1656366434069,“updated_by”:“someone@example.com”,“delta_sharing_enabled”:真正的,“所有者”:“someone@example.com”,“delta_sharing_recipient_token_lifetime_in_seconds”:86400年,“地区”:“us-west-2”,“storage_root_credential_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“云”:“aws”,“global_metastore_id”:“aws:美国-西方- 2:12a345b6 - 7890 - 1 - cd2 - 3456 e789f0a12b34”,“delta_sharing_scope”:“INTERNAL_AND_EXTERNAL”,“privilege_model_version”:“0.1”}

总结当前metastore信息

显示使用文档,运行unity-catalogmetastores得到概要——帮助

砖unity-catalog metastores得到概要

输出:

{“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“名称”:“my-metastore”,“default_data_access_config_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“storage_root_credential_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“云”:“aws”,“地区”:“us-west-2”,“global_metastore_id”:“aws:美国-西方- 2:12a345b6 - 7890 - 1 - cd2 - 3456 e789f0a12b34”,“storage_root_credential_name”:“my-storage-root-credential”}

获取当前metastore赋值为一个工作区

显示使用文档,运行unity-catalogmetastores来分派任务——帮助

砖unity-catalog metastores来分派任务

输出:

{“workspace_id”:1234567890123456,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“default_catalog_name”:“主要”}

删除一个metastore

警告

在删除一个metastore之前,您必须删除任何工作区使用metastore工作区或删除metastore链接。接触砖支持援助从工作区移除metastore链接。

显示使用文档,运行unity-catalogmetastores删除——帮助

强行删除metastore,使用——力选择。

砖unity-catalog metastores删除——id 12 a345b6张cd - 7890 - 1 - 3456 e789f0a12b34

metastore ID,运行unity-catalogmetastores得到概要。例如,看到的总结当前metastore信息

如果操作成功,不返回结果。

存储凭证

使用unity-catalogstorage-credentials子命令处理存储凭证

显示使用文档,运行unity-catalogstorage-credentials——帮助

创建一个存储凭证

显示使用文档,运行unity-catalogstorage-credentials创建——帮助

另请参阅创建一个存储凭证

砖unity-catalog storage-credentials创建——json文件create-storage-credential.json

create-storage-credential.json:

{“名称”:“my-storage-root-credential”,“aws_iam_role”:{“role_arn”:“攻击:aws:我::123456789012:角色/我的角色”}}

输出:

{“id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“名称”:“my-storage-root-credential”,“aws_iam_role”:{“role_arn”:“攻击:aws:我::123456789012:角色/我的角色”,“unity_catalog_iam_arn”:“攻击:aws:我::414351767826:角色/我的角色”,“external_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”},“所有者”:“someone@example.com”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656366379705,“created_by”:“someone@example.com”,“updated_at”:1656366379705,“updated_by”:“someone@example.com”,“used_for_managed_storage”:真正的}

更新存储凭证的设置

显示使用文档,运行unity-catalogstorage-credentials更新——帮助。另请参阅重命名一个存储凭证

砖unity-catalog storage-credentials更新——名字my-storage-root-credential json文件update-storage-credential.json

update-storage-credential.json:

{“名称”:“my-storage-root-credential-2”,“aws_iam_role”:{“role_arn”:“攻击:aws:我::123456789012:角色/我的角色”}}

输出:

{“id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“名称”:“my-storage-root-credential-2”,“aws_iam_role”:{“role_arn”:“攻击:aws:我::123456789012:角色/我的角色”,“unity_catalog_iam_arn”:“攻击:aws:我::414351767826:角色/我的角色”,“external_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”},“所有者”:“someone@example.com”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656366379705,“created_by”:“someone@example.com”,“updated_at”:1656366379705,“updated_by”:“someone@example.com”,“used_for_managed_storage”:真正的}

列出可用的存储凭证

显示使用文档,运行unity-catalogstorage-credentials列表——帮助。另请参阅列表存储凭证

砖unity-catalog storage-credentials列表

输出:

“storage_credentials”:({“id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“名称”:“my-storage-root-credential”,“aws_iam_role”:{“role_arn”:“攻击:aws:我::123456789012:角色/我的角色”,“unity_catalog_iam_arn”:“攻击:aws:我::123456789012:角色/我的角色”,“external_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”},“所有者”:“someone@example.com”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656366379705,“created_by”:“someone@example.com”,“updated_at”:1656366379705,“updated_by”:“someone@example.com”,“used_for_managed_storage”:真正的},{“…”:“…”}]

得到信息存储凭证

显示使用文档,运行unity-catalogstorage-credentials得到——帮助。另请参阅查看存储凭证

砖unity-catalog storage-credentials my-storage-root-credential得到,名称

输出:

{“id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“名称”:“my-storage-root-credential”,“aws_iam_role”:{“role_arn”:“攻击:aws:我::123456789012:角色/ my-storage-root-credential”,“unity_catalog_iam_arn”:“攻击:aws:我::414351767826:角色/我的角色”,“external_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”},“所有者”:“someone@example.com”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656353829777,“created_by”:“someone@example.com”,“updated_at”:1656353829777,“updated_by”:“someone@example.com”}

删除存储凭证

显示使用文档,运行unity-catalogstorage-credentials删除——帮助。另请参阅删除存储凭证

强行删除存储凭证使用——力选择。

砖unity-catalog storage-credentials my-storage-root-credential删除——名称

如果操作成功,不返回结果。

外部位置

使用unity-catalogexternal-locations子命令处理外部位置

显示使用文档,运行unity-catalogexternal-locations——帮助

创建一个外部位置

显示使用文档,运行unity-catalogexternal-locations创建——帮助。另请参阅创建一个外部位置

砖unity-catalog external-locations my-external-location创建——名称\——url s3: / /桶/ abcdefghij\——storage-credential-name my-storage-root-credential

输出:

{“名称”:“my-external-location”,“url”:“s3: / /桶/ abcdefghij”,“credential_name”:“my-storage-root-credential”,“所有者”:“someone@example.com”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“credential_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656370003059,“created_by”:“someone@example.com”,“updated_at”:1656370003059,“updated_by”:“someone@example.com”,“read_only”:}

验证一个外部位置和凭证

显示使用文档,运行unity-catalogexternal-locations验证——帮助

验证外部位置URL和凭据对之前创建它们

砖unity-catalog external-locations验证——url s3: / /桶/ abcdefghij\——cred-name my-storage-root-credential

输出:

{“isDir”:真正的,“结果”:({“操作”:“读”,“结果”:“通过”},{“操作”:“列表”,“结果”:“通过”},{“操作”:“写”,“结果”:“通过”},{“操作”:“删除”,“结果”:“通过”}]}

验证一个外部位置名称和证书对在您创建它们

砖unity-catalog external-locations my-external-location验证——名称\——cred-name my-storage-root-credential

输出:

{“isDir”:真正的,“结果”:({“操作”:“读”,“结果”:“通过”},{“操作”:“列表”,“结果”:“通过”},{“操作”:“写”,“结果”:“通过”},{“操作”:“删除”,“结果”:“通过”}]}

更新外部位置的设置

显示使用文档,运行unity-catalogexternal-locations更新——帮助。另请参阅修改外部位置

砖unity-catalog external-locations my-external-location更新——名称\——json文件update-external-location.json

udpate-external-location.json:

{“名称”:“my-external-location-2”}

输出:

{“名称”:“my-external-location-2”,“url”:“s3: / /桶/ abcdefghij”,“credential_name”:“my-storage-root-credential”,“所有者”:“someone@example.com”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“credential_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656370003059,“created_by”:“someone@example.com”,“updated_at”:1656370379651,“updated_by”:“someone@example.com”,“read_only”:}

列出可用的外部位置

显示使用文档,运行unity-catalogexternal-locations列表——帮助

砖unity-catalog external-locations列表

输出:

{“external_locations”:({“名称”:“my-external-location”,“url”:“s3: / /桶/ abcdefghij”,“credential_name”:“my-storage-root-credential”,“所有者”:“someone@example.com”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“credential_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656370003059,“created_by”:“someone@example.com”,“updated_at”:1656370379651,“updated_by”:“someone@example.com”,“read_only”:},{“…”:“…”}]}

获取外部信息的位置

显示使用文档,运行unity-catalogexternal-locations得到——帮助。另请参阅描述外部位置

砖unity-catalog external-locations my-external-location得到,名称

输出:

{“名称”:“my-external-location”,“url”:“s3: / /桶/ abcdefghij”,“credential_name”:“my-storage-root-credential”,“所有者”:“someone@example.com”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“credential_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656370003059,“created_by”:“someone@example.com”,“updated_at”:1656370003059,“updated_by”:“someone@example.com”,“read_only”:}

删除外部位置

显示使用文档,运行unity-catalogexternal-locations删除——帮助。另请参阅删除外部位置

强行删除外部位置,使用——力选择。

砖unity-catalog external-locations my-external-location删除——名称

如果操作成功,不返回结果。

目录

使用unity-catalog目录子命令处理目录

显示使用文档,运行unity-catalog目录——帮助

创建一个目录

显示使用文档,运行unity-catalog目录创建——帮助。另请参阅创建一个目录

砖unity-catalog目录创建——我的目录名称

输出:

{“名称”:“我的目录”,“所有者”:“someone@example.com”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656113178995,“created_by”:“someone@example.com”,“updated_at”:1656113178995,“updated_by”:“someone@example.com”,“catalog_type”:“MANAGED_CATALOG”}

更新目录的设置

显示使用文档,运行unity-catalog目录更新——帮助

砖unity-catalog目录更新——我的目录名称\——json文件update-catalog.json

update-catalog.json:

{“名称”:“my-catalog-2”,“所有者”:“someone@example.com”}

输出:

{“名称”:“my-catalog-2”,“所有者”:“someone@example.com”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656355967835,“created_by”:“someone@example.com”,“updated_at”:1656356095989,“updated_by”:“someone@example.com”,“catalog_type”:“MANAGED_CATALOG”}

可用的目录列表

显示使用文档,运行unity-catalog目录列表——帮助

砖unity-catalog目录列表

输出:

{“目录”:({“名称”:“主要”,“所有者”:“someone@example.com”,“评论”:“主目录(自动创建)”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656112029355,“created_by”:“someone@example.com”,“updated_at”:1656112029355,“updated_by”:“someone@example.com”,“catalog_type”:“MANAGED_CATALOG”},{“…”:“…”}]}

得到一个目录的信息

显示使用文档,运行unity-catalog目录得到——帮助

砖unity-catalog目录得到——我的目录名称

输出:

{“名称”:“我的目录”,“所有者”:“someone@example.com”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656113178995,“created_by”:“someone@example.com”,“updated_at”:1656113178995,“updated_by”:“someone@example.com”,“catalog_type”:“MANAGED_CATALOG”}

删除一个目录

显示使用文档,运行unity-catalog目录删除——帮助。另请参阅删除一个目录

强行删除一个目录,使用——清除选择。

砖unity-catalog目录删除,我的目录名称

如果操作成功,不返回结果。

模式

使用unity-catalog模式子命令处理模式

显示使用文档,运行unity-catalog模式——帮助

创建一个模式

显示使用文档,运行unity-catalog模式创建——帮助。另请参阅创建一个模式

砖unity-catalog模式创建的目录名称,我的目录\——名字我模式

输出:

{“名称”:“我模式”,“catalog_name”:“我的目录”,“所有者”:“someone@example.com”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“full_name”:“my-catalog.my-schema”,“created_at”:1656113607800,“created_by”:“someone@example.com”,“updated_at”:1656113607800,“updated_by”:“someone@example.com”}

改变模式的设置

显示使用文档,运行unity-catalog模式更新——帮助

砖unity-catalog模式更新,全名my-catalog.my-schema\——json文件update-schema.json

update-schema.json:

{“名称”:“my-schema-2”,“所有者”:“someone@example.com”}

输出:

{“名称”:“my-schema-2”,“catalog_name”:“我的目录”,“所有者”:“someone@example.com”,“评论”:“默认模式(自动创建)”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“full_name”:“my-catalog.my-schema-2”,“created_at”:1656355967837,“created_by”:“someone@example.com”,“updated_at”:1656356592786,“updated_by”:“someone@example.com”}

列出可用的模式

显示使用文档,运行unity-catalog模式列表——帮助

砖unity-catalog模式——目录名称列表我的目录

输出:

{“模式”:({“名称”:“默认”,“catalog_name”:“我的目录”,“所有者”:“someone@example.com”,“评论”:“默认模式(自动创建)”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“full_name”:“my-catalog.default”,“created_at”:1656113178996,“created_by”:“someone@example.com”,“updated_at”:1656113178996,“updated_by”:“someone@example.com”},{“…”:“…”}]}

得到信息模式

显示使用文档,运行unity-catalog模式得到——帮助

砖unity-catalog模式得到,全名my-catalog.my-schema

输出:

{“名称”:“我模式”,“catalog_name”:“我的目录”,“所有者”:“someone@example.com”,“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“full_name”:“my-catalog.my-schema”,“created_at”:1656113607800,“created_by”:“someone@example.com”,“updated_at”:1656113607800,“updated_by”:“someone@example.com”}

删除一个模式

显示使用文档,运行unity-catalog模式删除——帮助。另请参阅删除一个模式

强行删除模式,使用——清除选择。

砖unity-catalog模式删除——全名my-catalog.my-schema

如果操作成功,不返回结果。

使用unity-catalog子命令处理

请注意

创建表和不支持统一编目CLI。创建表,请参阅创建表创建您的第一个表和管理权限

显示使用文档,运行unity-catalog——帮助

列出可用的表

显示使用文档,运行unity-catalog列表——帮助

砖unity-catalog表列出,主要目录名称\——默认模式名称

输出:

{“表”:({“名称”:“mytable”,“catalog_name”:“主要”,“schema_name”:“默认”,“table_type”:“管理”,“data_source_format”:“δ”,“列”:({“名称”:“id”,“type_text”:“int”,“type_json”:“{\“\”:\“id \”, \“\”, \“整数\”,\“nullable \”:真的,\ \“元数据”:{}}”,“type_name”:“INT”,“type_precision”:0,“type_scale”:0,“位置”:0,“可以为空”:真正的},{“名称”:“名称”,“type_text”:“字符串”,“type_json”:“{\“\”:\“\”,\“\”,\“\”,\“nullable \”:真的,\ \“元数据”:{}}”,“type_name”:“字符串”,“type_precision”:0,“type_scale”:0,“位置”:1,“可以为空”:真正的},{“名称”:“年龄”,“type_text”:“int”,“type_json”:“{\“\”:\“年龄\”,\“\”,\“整数\”,\“nullable \”:真的,\ \“元数据”:{}}”,“type_name”:“INT”,“type_precision”:0,“type_scale”:0,“位置”:2,“可以为空”:真正的}),“storage_location”:“s3: / /桶/ abcdefghij / 12 a345b6张cd - 7890 - 1 - 3456 e789f0a12b34 /表/ 12 a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“所有者”:“someone@example.com”,“属性”:{“delta.lastCommitTimestamp”:“1656371979000”,“delta.lastUpdateVersion”:“0”,“delta.minWriterVersion”:“2”,“delta.minReaderVersion”:“1”,“delta.checkpoint.writeStatsAsStruct”:“真正的”,“delta.checkpoint.writeStatsAsJson”:“假”},“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“full_name”:“main.default.mytable”,“data_access_configuration_id”:“00000000-0000-0000-0000-000000000000”,“created_at”:1656371992807,“created_by”:“someone@example.com”,“updated_at”:1656371992807,“updated_by”:“someone@example.com”,“table_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”},{“…”:“…”}]}

列表总结可用的表

显示使用文档,运行unity-cataloglist-summaries——帮助

砖unity-catalog表list-summaries——主要目录名称

输出:

{“表”:({“full_name”:“main.default.mytable”,“table_type”:“管理”},{“…”:“…”}]}

得到的信息表

显示使用文档,运行unity-catalog得到——帮助

砖unity-catalog表得到,全名main.default.mytable

输出:

{“名称”:“mytable”,“catalog_name”:“主要”,“schema_name”:“默认”,“table_type”:“管理”,“data_source_format”:“δ”,“列”:({“名称”:“id”,“type_text”:“int”,“type_json”:“{\“\”:\“id \”, \“\”, \“整数\”,\“nullable \”:真的,\ \“元数据”:{}}”,“type_name”:“INT”,“type_precision”:0,“type_scale”:0,“位置”:0,“可以为空”:真正的},{“名称”:“名称”,“type_text”:“字符串”,“type_json”:“{\“\”:\“\”,\“\”,\“\”,\“nullable \”:真的,\ \“元数据”:{}}”,“type_name”:“字符串”,“type_precision”:0,“type_scale”:0,“位置”:1,“可以为空”:真正的},{“名称”:“年龄”,“type_text”:“int”,“type_json”:“{\“\”:\“年龄\”,\“\”,\“整数\”,\“nullable \”:真的,\ \“元数据”:{}}”,“type_name”:“INT”,“type_precision”:0,“type_scale”:0,“位置”:2,“可以为空”:真正的}),“storage_location”:“s3: / /桶/ abcdefghij / 12 a345b6张cd - 7890 - 1 - 3456 e789f0a12b34 /表/ 12 a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“所有者”:“someone@example.com”,“属性”:{“delta.lastCommitTimestamp”:“1656371979000”,“delta.lastUpdateVersion”:“0”,“delta.minWriterVersion”:“2”,“delta.minReaderVersion”:“1”,“delta.checkpoint.writeStatsAsStruct”:“真正的”,“delta.checkpoint.writeStatsAsJson”:“假”},“metastore_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“full_name”:“main.default.mytable”,“data_access_configuration_id”:“00000000-0000-0000-0000-000000000000”,“created_at”:1656371992807,“created_by”:“someone@example.com”,“updated_at”:1656371992807,“updated_by”:“someone@example.com”,“table_id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”}

删除一个表

显示使用文档,运行unity-catalog删除——帮助

砖unity-catalog表删除,全名main.default.mytable

如果操作成功,不返回结果。

血统

使用unity-catalog血统子命令表和列的血统。

显示使用文档,运行unity-catalog血统——帮助

列出一个表的血统

显示使用文档,运行unity-catalog血统——帮助

砖unity-catalog血统表,表名main.default.mytable\——水平1

列出一个列的血统

显示使用文档,运行unity-catalog血统——帮助

砖unity-catalog血统的列,表名main.default.mytable\——列名id

权限

使用unity-catalog权限子命令的权限可获得的对象。另请参阅统一目录管理权限

显示使用文档,运行unity-catalog权限——帮助

获得一个可获得的对象的权限信息

显示使用文档,运行unity-catalog权限得到——帮助。另请参阅统一目录权限和可获得的对象

目录

砖unity-catalog得到,主要目录权限

输出:

{“privilege_assignments”:({“校长”:“用户帐户”,“特权”:(“使用目录”]}]}

模式

砖unity-catalog main.default权限得到——模式

输出:

{“privilege_assignments”:({“校长”:“用户帐户”,“特权”:(“使用模式”]}]}

砖unity-catalog main.default.mytable得到,表的权限

输出:

{“privilege_assignments”:({“校长”:“用户帐户”,“特权”:(“选择”]}]}

存储凭证

砖unity-catalog权限得到,storage-credential my-storage-root-credential

输出:

{“privilege_assignments”:({“校长”:“用户帐户”,“特权”:(“read_file”]}]}

外部位置

砖unity-catalog权限得到,外部位置的my-external-location

输出:

{“privilege_assignments”:({“校长”:“用户帐户”,“特权”:(“read_file”]}]}

更新一个可获得的对象的权限

显示使用文档,运行unity-catalog权限更新——帮助。另请参阅统一目录权限和可获得的对象

目录

砖unity-catalog权限更新目录\——json文件update-catalog-permissions.json

update-catalog-permissions.json:

{“改变”:({“校长”:“用户帐户”,“添加”:(“使用目录”),“删除”:(“创建模式”]}]}

模式

砖unity-catalog权限更新模式\——json文件update-schema-permissions.json

update-schema-permissions.json:

{“改变”:({“校长”:“用户帐户”,“添加”:(“使用模式”),“删除”:(“CREATE TABLE”]},{“校长”:“管理团队”,“添加”:(“CREATE TABLE”]}]}

砖unity-catalog权限更新表\——json文件update-table-permissions.json

update-table-permissions.json:

{“改变”:({“校长”:“用户帐户”,“添加”:(“选择”),“删除”:(“修改”]},{“校长”:“管理团队”,“添加”:(“所有”]}]}

存储凭证

更新——storage-credential砖unity-catalog权限\——json文件update-storage-credential-permissions.json

update-storage-credential-permissions.json:

{“改变”:({“校长”:“用户帐户”,“删除”:(“读文件”]},{“校长”:“存储团队”,“添加”:(“读文件”,“写文件”,“创建外部表”]},{“校长”:“管理团队”,“添加”:(“所有”]}]}

外部位置

砖unity-catalog权限更新——外部位置的过程\——json文件update-external-location-permissions.json

update-external-location-permissions.json:

{“改变”:({“校长”:“用户帐户”,“删除”:(“读文件”]},{“校长”:“存储团队”,“添加”:(“读文件”,“写文件”,“创建外部表”]},{“校长”:“管理团队”,“添加”:(“所有”]}]}

股票

使用unity-catalog股票子命令与股份,合作对象包含的集合表的三角洲共享启用统一目录metastore要与三角洲分享作为一个群体共享接受者。分享可以包含从只有一个metastore表。看到创建和管理股票三角洲共享

显示使用文档,运行unity-catalog股票——帮助

创建一个共享

显示使用文档,运行unity-catalog股票创建——帮助。另请参阅创建和管理股票三角洲共享

砖unity-catalog股票创造——名字我的股份

输出:

{“名称”:“我”,“created_at”:1656433327533,“created_by”:“someone@example.com”,“所有者”:“someone@example.com”}

更新一个共享的设置

显示使用文档,运行unity-catalog股票更新——帮助。另请参阅更新股票

添加一个表

砖unity-catalog股票更新——名字我的股份\- - - add table main.default.mytable

输出:

{“名称”:“我”,“对象”:({“名称”:“main.default.mytable”,“data_object_type”:“表”,“added_at”:1656434168847,“added_by”:“someone@example.com”,“shared_as”:“default.mytable”,“cdf_enabled”:}),“created_at”:1656433327533,“created_by”:“someone@example.com”,“所有者”:“someone@example.com”}

另请参阅将表添加到一个份额

删除一个表

砖unity-catalog股票更新——名字我的股份\——remove-table main.default.mytable

输出:

{“名称”:“我”,“created_at”:1656433327533,“created_by”:“someone@example.com”,“所有者”:“someone@example.com”}

另请参阅将表添加到一个份额

更新一个共享的权限

显示使用文档,运行unity-catalog股票update-permissions——帮助。另请参阅授予和管理访问三角洲共享数据的股票

砖unity-catalog股票update-permissions——名字我的股份\——json文件update-share-permissions.json

update-share-permissions.json:

{“privilege_assignments”:({“校长”:“my-recipient”,“特权”:(“选择”]}]}

列出可用的股票

显示使用文档,运行unity-catalog股票列表——帮助。另请参阅查看股票和分享的细节

砖unity-catalog股票列表

输出:

{“股票”:({“名称”:“我”,“created_at”:1656433327533,“created_by”:“someone@example.com”,“所有者”:“someone@example.com”},{“…”:“…”}]}

得到的信息

显示使用文档,运行unity-catalog股票得到——帮助。另请参阅查看股票和分享的细节

砖unity-catalog股票得到,名字我的股份

输出:

{“名称”:“我”,“created_at”:1656433327533,“created_by”:“someone@example.com”,“所有者”:“someone@example.com”}

共享的权限列表

显示使用文档,运行unity-catalog股票list-permissions——帮助。另请参阅查看受者有权限

砖unity-catalog股票list-permissions——名字我的股份

输出:

{“privilege_assignments”:({“校长”:“my-recipient”,“特权”:(“选择”]}]}

删除一个分享

显示使用文档,运行unity-catalog股票删除——帮助。另请参阅删除一个分享

砖unity-catalog股票删除——名字我的股份

如果操作成功,不返回结果。

收件人

使用unity-catalog收件人子命令与数据接收者三角洲共享统一目录metastores启用。数据接收人或团体砖的砖用户共享的数据与外部用户的组织。看到创建和管理数据接收者三角洲共享

显示使用文档,运行unity-catalog收件人——帮助

创建一个收件人

显示使用文档,运行unity-catalog收件人创建——帮助。另请参阅创建和管理数据接收者三角洲共享

生成一个新的激活接受者的URL,运行unity-catalog收件人rotate-token。例如,看到的旋转一个收件人的令牌

砖unity-catalog my-recipient收件人创建——名称

输出:

{“名称”:“my-recipient”,“created_at”:1656435288003,“created_by”:“someone@example.com”,“令牌”:({“id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656435288005,“created_by”:“someone@example.com”,“activation_url”:“https://example.com/delta_sharing/retrieve_config.html? <惟一的id >”,“expiration_time”:1656521688006,“updated_at”:1656435288006,“updated_by”:“someone@example.com”}),“authentication_type”:“令牌”,“updated_at”:1656435288003,“updated_by”:“someone@example.com”,“所有者”:“someone@example.com”}

改变一个收件人的设置

显示使用文档,运行unity-catalog收件人更新——帮助

砖unity-catalog my-recipient收件人更新——名称\——json文件update-recipient-settings.json

update-recipient-settings.json:

{“名称”:“my-recipient-2”}

输出:

{“名称”:“my-recipient-2”,“created_at”:1656435288003,“created_by”:“someone@example.com”,“令牌”:({“id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656435288005,“created_by”:“someone@example.com”,“expiration_time”:1656436808507,“updated_at”:1656435908507,“updated_by”:“someone@example.com”},{“id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656435908509,“created_by”:“someone@example.com”,“activation_url”:“https://example.com/delta_sharing/retrieve_config.html? <惟一的id >”,“expiration_time”:1656522308510,“updated_at”:1656435908510,“updated_by”:“someone@example.com”}),“authentication_type”:“令牌”,“updated_at”:1656436740986,“updated_by”:“someone@example.com”,“所有者”:“someone@example.com”}

旋转一个收件人的令牌

显示使用文档,运行unity-catalog收件人rotate-token——帮助。另请参阅管理接受者令牌(开放共享)

砖unity-catalog接受者rotate-token my-recipient——名称\——existing-token-expire-in-seconds900年

输出:

{“名称”:“my-recipient”,“created_at”:1656435288003,“created_by”:“someone@example.com”,“令牌”:({“id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656435288005,“created_by”:“someone@example.com”,“expiration_time”:1656436808507,“updated_at”:1656435908507,“updated_by”:“someone@example.com”},{“id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656435908509,“created_by”:“someone@example.com”,“activation_url”:“https://example.com/delta_sharing/retrieve_config.html? <惟一的id >”,“expiration_time”:1656522308510,“updated_at”:1656435908510,“updated_by”:“someone@example.com”}),“authentication_type”:“令牌”,“updated_at”:1656435288003,“updated_by”:“someone@example.com”,“所有者”:“someone@example.com”}

列出可用的接受者

显示使用文档,运行unity-catalog收件人列表——帮助。另请参阅查看收件人

砖unity-catalog接收人列表

输出:

{“收件人”:({“名称”:“my-recipient”,“created_at”:1656435288003,“created_by”:“someone@example.com”,“令牌”:({“id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656435288005,“created_by”:“someone@example.com”,“activation_url”:“https://example.com/delta_sharing/retrieve_config.html? <惟一的id >”,“expiration_time”:1656521688006,“updated_at”:1656435288006,“updated_by”:“someone@example.com”}),“authentication_type”:“令牌”,“updated_at”:1656435288003,“updated_by”:“someone@example.com”,“所有者”:“someone@example.com”}]}

接收方的共享权限列表

显示使用文档,运行unity-catalog收件人list-permissions——帮助。另请参阅查看收件人的共享权限

砖unity-catalog接受者list-permissions my-recipient——名称

输出:

{“permissions_out”:({“share_name”:“我”,“privilege_assignments”:({“特权”:(“选择”]}]}]}

信息接收方

显示使用文档,运行unity-catalog收件人得到——帮助。另请参阅查看收件人详细信息

砖unity-catalog my-recipient接受者得到,名称

输出:

{“名称”:“my-recipient”,“created_at”:1656435288003,“created_by”:“someone@example.com”,“令牌”:({“id”:“十二a345b6张cd - 7890 - 1 - 3456 e789f0a12b34”,“created_at”:1656435288005,“created_by”:“someone@example.com”,“activation_url”:“https://example.com/delta_sharing/retrieve_config.html? <惟一的id >”,“expiration_time”:1656521688006,“updated_at”:1656435288006,“updated_by”:“someone@example.com”}),“authentication_type”:“令牌”,“updated_at”:1656435288003,“updated_by”:“someone@example.com”,“所有者”:“someone@example.com”}

删除一个收件人

显示使用文档,运行unity-catalog收件人删除——帮助。另请参阅删除一个收件人

砖unity-catalog接受者my-recipient删除——名称

如果操作成功,不返回结果。

供应商

如果你是一个三角洲共享共享数据接收者,使用unity-catalog供应商子命令与三角洲共享数据提供者。看到管理三角洲共享供应商(数据接受者)

显示使用文档,运行unity-catalog供应商——帮助

创建一个提供者

如果你是一个接收的数据共享使用开放共享协议和您使用的是一个砖工作区metastore附加到统一目录,您可以创建一个供应商统一目录metastore对象。然后您可以使用统一目录管理访问共享数据。

另请参阅砖:读取共享数据使用统一目录

创建一个提供者,您必须:

运行以下命令,取代我的供应者与你想要的名字给提供者config.share你下载的证书文件的路径,叫配置。默认分享。

砖unity-catalog提供者创建的,名字我的供应者\——recipient-profile-json-file config.share

更新一个提供者的设置

显示使用文档,运行unity-catalog供应商更新——帮助

砖unity-catalog供应商更新——名字我的供应者\——新名字my-provider-2

可用提供者列表

显示使用文档,运行unity-catalog供应商列表——帮助

砖unity-catalog供应商列表

得到的信息提供者

显示使用文档,运行unity-catalog供应商得到——帮助

砖unity-catalog提供商得到,名字我的供应者

可用一个提供者的列表

显示使用文档,运行unity-catalog供应商上市——帮助

砖unity-catalog提供者上市——名字我的供应者

删除一个提供者

显示使用文档,运行unity-catalog供应商删除——帮助

砖unity-catalog提供者删除——名字我的供应者

如果操作成功,不返回结果。