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łową tabelę Delta do docelowej lokalizacji 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łowe tabele Parquet i Iceberg. Sprawdź przyrostowe klonowanie tabel Parquet i Iceberg do Delta Lake.

W Databricks SQL i Databricks Runtime 13.3 LTS i nowszych można używać płytkich klonów w zarządzanych tabelach Unity Catalog. W środowisku Databricks Runtime 12.2 LTS lub wcześniejszych nie ma obsługi płytkich klonów w Unity Catalog. Zobacz Płytkie klonowanie tabel Unity Catalog.

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 tabeli 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]

Parametry

  • 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, tabela zostanie zastąpiona, jeśli istnieje, lub nowo utworzona, jeśli nie. CREATE OR Bez table_name musi istnieć.

  • table_name

    Nazwa tabeli Delta Lake do utworzenia. Nazwa nie może zawierać specyfikacji czasowej ani specyfikacji opcji. Jeśli nazwa nie jest kwalifikowana, tabela zostanie utworzona w bieżącym schemacie. 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 tabeli źródłowej, ale będzie odwoływać się do plików tej tabeli. Po określeniu DEEP CLONE (ustawienie domyślne) usługa Azure Databricks utworzy kompletną, niezależną kopię tabeli źródłowej.

  • source_table_name

    Nazwa tabeli usługi Delta Lake, 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 tabelę zewnętrzną z podaną lokalizacją jako ścieżką, w której są przechowywane dane. Jeśli table_name jest ścieżką zamiast identyfikatora tabeli, 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 tabeli w usłudze Azure Databricks.