創建目錄

適用於:勾選“是”磚的SQL勾選“是”Databricks Runtime 10.3及以上版本勾選“是”僅限Unity目錄

創建具有指定名稱的目錄。如果已經存在同名的目錄，則拋出異常。

語法

創建目錄［如果不存在］catalog_name［使用分享provider_name．share_name］［管理位置“location_path”］［評論評論］

參數

  • 如果不存在

    如果給定名稱不存在，則創建具有該名稱的目錄。如果已經存在同名的目錄，則不會發生任何事情。

  • catalog_name

    要創建的目錄的名稱。

  • 使用共享provider_name．share_name

    類可選地指定目錄基於共享份額．

  • 管理位置“location_path”

    可選地指定目錄的存儲根位置的路徑，該路徑與metastore的存儲根位置不同。類型中必須定義此路徑外部位置配置，你必須有創建管理存儲外部位置配置上的特權。您可以使用外部位置配置中定義的路徑或子路徑(換句話說，“s3: / /部門/金融”或s3: / /部門/金融/產品的)．在Databricks SQL或運行Databricks Runtime 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: / /部門/金融”；