创建目录

适用于:检查标记是的砖的SQL检查标记是的砖运行时10.3及以上检查标记是的统一目录只

创建一个目录指定名称。如果一个具有相同名称的目录已经存在,就会抛出一个异常。

当您创建一个外国目录将会填充所有的模式及其表可见,对用户进行身份验证。

语法

创建目录(如果存在]catalog_name(使用分享provider_nameshare_name](管理位置“location_path”](评论评论]创建外国目录(如果存在]catalog_name使用连接connection_name(评论评论]选项({option_name=option_value}(,])

参数

  • 外国

    适用于:检查标记是的砖的SQL检查标记是的砖运行时13.1及以后

    指定的目录是进口连接

  • 如果不存在

    用给定的名称创建一个目录,如果不存在。如果一个具有相同名称的目录已经存在,什么也不会发生。

  • catalog_name

    要创建目录的名称。

  • 使用共享provider_nameshare_name

    选择是基于一个指定的目录三角洲分享分享

  • 管理位置“location_path”

    (可选)指定目录的路径管理的存储位置,比metastore不同的根存储位置。这条路必须定义在一个外部位置配置,你必须有创建管理存储特权在外部位置配置。您可以使用路径中定义外部位置配置或子路径(换句话说,“gs: / /部门/金融”“gs: / /部门/金融/产品)。在集群运行数据砖砖SQL或运行时支持11.3以上。

    另请参阅管理表配置一个谷歌云存储桶

  • 使用连接connection_name

    指定源目录所在的连接。

  • 评论

    一个可选的字符串文字。目录的描述。

  • 选项

    设置连接类型特定的参数需要确定目录的连接。

    • 选项

      选择的关键。可以包含一个或多个的关键标识符由一个点或一个字符串文字。

      选择键必须是唯一的,是区分大小写的。

    • 价值

      选项的值。必须是一个值布尔,字符串,整数,或小数常数表达式。也可以调用的值秘密SQL函数。例如,价值密码可能由秘密(“secrets.r.us”,“postgresPassword”)而不是进入文字密码。

例子

——创建目录“customer_cat”。这个如果目录名称customer_cat抛出异常——已经存在。>创建目录customer_cat;——创建目录的customer_cat只有与同名目录不存在。>创建目录如果存在customer_cat;——创建目录“customer_cat”只有目录相同的名称不存在,与评论。>创建目录如果存在customer_cat评论这是客户目录”;从三角洲分享分享,创建一个目录。>创建目录customer_cat使用分享疾病预防控制中心vaccinedata;——创建一个目录使用不同的管理比metastore的存储位置。>创建目录customer_cat管理位置“gs: / /部门/金融”;——创建一个外国目录与postgresdb postgresql_connection>创建外国目录postgresql_catalog使用连接postgresql_connection选项(数据库“postgresdb”);