Udostępnij za pośrednictwem

CREATE TABLE CLONE

  • Artykuł

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime

Klonuje źródło Delta table do docelowego miejsca w określonej wersji. Klon może być głęboki lub płytki: głębokie klony kopiują dane ze źródła i płytkie klony nie. Możesz również sklonować źródło Parquet i Iceberg tables. Zobacz przyrostowe klonowanie Parquet i Iceberg tables do Delta Lake.

W usługach Databricks SQL i Databricks Runtime 13.3 LTS i nowszych można używać płytkich klonów za pomocą środowiska Unity Catalog zarządzanego tables. W środowisku Databricks Runtime 12.2 LTS i poniżej nie ma obsługi płytkich klonów w środowisku Unity Catalog. Zobacz Płytkie klonowanie dla środowiska Unity Catalogtables.

Ważne

Istnieją ważne różnice między płytkimi i głębokimi klonami, które mogą określić, jak najlepiej z nich korzystać. Zobacz Klonowanie table w usłudze Azure Databricks.

Składnia

CREATE TABLE [IF NOT EXISTS] table_name
   [SHALLOW | DEEP] CLONE source_table_name [TBLPROPERTIES clause] [LOCATION path]

[CREATE OR] REPLACE TABLE table_name
   [SHALLOW | DEEP] CLONE source_table_name [TBLPROPERTIES clause] [LOCATION path]

Parameters

  • JEŚLI NIE ISTNIEJE

    Jeśli zostanie określona, instrukcja zostanie zignorowana, jeśli table_name już istnieje.

  • [UTWÓRZ LUB] ZASTĄPIĆ

    Jeśli CREATE OR zostanie określony, table zostanie zamieniony, jeśli istnieje, lub utworzony na nowo, jeśli nie istnieje. CREATE OR Bez table_name musi istnieć.

  • table_name

    Nazwa table Delta Lake, która ma zostać utworzona. Nazwa nie może zawierać specyfikacji czasowej ani specyfikacji opcji. Jeśli nazwa nie jest kwalifikowana, table zostanie utworzona w bieżącym schema. table_name nie może już istnieć, chyba że REPLACE określono lub IF NOT EXISTS został określony.

  • PŁYTKI KLON LUBKLON GŁĘBOKI

    Jeśli określisz SHALLOW CLONE, usługa Azure Databricks utworzy kopię definicji źródłowej table, ale będzie odwoływać się do źródłowych plików table. Po określeniu DEEP CLONE (ustawienie domyślne) usługa Azure Databricks utworzy kompletną, niezależną kopię tableźródłowej .

  • source_table_name

    Nazwa Delta Lake table, która ma zostać sklonowana. Nazwa może zawierać specyfikację czasową lub specyfikację opcji.

  • TBLPROPERTIES

    Opcjonalnie ustawia co najmniej jedną właściwość zdefiniowaną przez użytkownika.

  • ŚCIEŻKA LOKALIZACJI

    Opcjonalnie tworzy zewnętrzne table, z podaną lokalizacją jako ścieżkę where, gdzie dane są przechowywane. Jeśli table_name jest ścieżką zamiast tableidentifier, operacja zakończy się niepowodzeniem. path musi być literałem STRING.

Przykłady

Można użyć CREATE TABLE CLONE w przypadku złożonych operacji, takich jak migracja danych, archiwizowanie danych, odtwarzanie przepływu uczenia maszynowego, krótkoterminowe eksperymenty i udostępnianie danych. Zobacz Klonowanie table w usłudze Azure Databricks.