创建目录

适用于:勾选“是”砖的SQL勾选“是”Databricks Runtime 10.3及以上版本

创建具有指定名称的目录。如果已经存在同名的目录，则抛出异常。

语法

创建目录［如果不存在］catalog_name［使用分享provider_name．share_name］［管理位置“location_path”］［评论评论］

参数

  • 如果不存在

    如果给定名称不存在，则创建具有该名称的目录。如果已经存在同名的目录，则不会发生任何事情。

  • catalog_name

    要创建的目录的名称。

  • 使用共享provider_name．share_name

    类可选地指定目录基于共享份额．

  • 管理位置“location_path”

    可选地指定目录的存储根位置的路径，该路径与metastore的存储根位置不同。类型中必须定义此路径外部位置配置，你必须有创建管理存储外部位置配置上的特权。您可以使用外部位置配置中定义的路径或子路径(换句话说，“s3: / /部门/金融”或s3: / /部门/金融/产品的)．要求Databricks运行时11.3及以上。另请参阅在AWS中配置存储桶和IAM角色．

  • 评论

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

例子

创建目录“customer_cat”。如果目录名称为customer_cat，则抛出异常——已经存在。>创建目录customer_cat；—仅在同名目录不存在时创建目录' customer_cat '。>创建目录如果不存在customer_cat；—仅在同名目录不存在时创建目录' customer_cat '，并添加注释。>创建目录如果不存在customer_cat评论“这是客户目录”；——从Delta Sharing共享创建一个目录。>创建目录customer_cat使用分享疾病预防控制中心．vaccinedata；—创建一个与metastore的存储根位置不同的目录。>创建目录customer_cat管理位置“s3: / /部门/金融”；