創建模式

適用於:勾選“是”磚的SQL勾選“是”磚運行時

創建具有指定名稱的模式。如果已經存在具有相同名稱的模式,則拋出異常。

語法

創建模式如果存在schema_name評論schema_comment位置schema_directory管理位置“location_path”DBPROPERTIESproperty_nameproperty_value...

參數

  • schema_name

    要創建的模式的名稱。

  • 如果不存在

    如果給定名稱不存在,則創建具有該名稱的模式。如果已經存在具有相同名稱的模式,則不會發生任何事情。

  • schema_directory

    要創建模式的文件係統路徑。如果指定的路徑在底層文件係統中不存在,則創建具有該路徑的目錄。如果沒有指定位置,則在默認倉庫目錄中創建模式,該目錄的路徑由靜態配置配置spark.sql.warehouse.dir

    警告

    為避免意外數據丟失,不要將模式(數據庫)注冊到使用現有數據的位置,也不要在由模式管理的位置中創建新的外部表。

    方法刪除模式級聯選項遞歸地刪除指定位置中的所有數據文件,而不管表類型(托管或外部)。

  • schema_comment

    模式的描述。

  • 管理位置“location_path”

    可選地指定模式的存儲根位置的路徑,該路徑與編目或亞存儲的存儲根位置不同。類型中必須定義此路徑外部位置配置,你必須有創建管理存儲外部位置配置上的特權。您可以使用外部位置配置中定義的路徑或子路徑(換句話說,“s3: / /部門/金融”s3: / /部門/金融/產品的).要求Databricks運行時11.3及以上。另請參閱在AWS中配置存儲桶和IAM角色

  • 使用DBPROPERTIES (property_name = property_value[,…])

    鍵-值對中的模式屬性。

例子

創建“customer_sc”模式。如果schema的名稱為customer_sc,則會拋出異常——已經存在。>創建模式customer_sc—隻在同名模式不存在時創建模式' customer_sc '。>創建模式如果存在customer_sc—隻在不存在同名模式時創建模式' customer_sc '-“評論”,“特定位置”和“數據庫屬性”。>創建模式如果存在customer_sc評論“這是客戶模式”位置/用戶的DBPROPERTIESID001名字“約翰。”);—確認屬性已設置。>描述模式擴展customer_scdatabase_description_itemdatabase_description_value------------------------- --------------------------數據庫名字customer_sc描述客戶模式位置hdfs//使hacluster/用戶屬性((ID001),名字約翰))—創建與metastore不同的存儲根位置的schema。>創建模式customer_sc管理位置“s3: / / us-east-1 /金融”