TWORZENIE KLONOWANIA TABELI

Dotyczy: Databricks SQL Databricks Runtime

Klonuje źródłową tabelę delty do miejsca docelowego 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. Zobacz Incrementally clone Parquet and Iceberg tables to Delta Lake (Przyrostowe klonowanie tabel Parquet i Góry Lodowej do usługi Delta Lake).

W usługach Databricks SQL i Databricks Runtime 13.3 LTS i nowszych można używać płytkich klonów z tabelami zarządzanymi w wykazie aparatu Unity. W środowisku Databricks Runtime 12.2 LTS i poniżej nie ma obsługi płytkich klonów w katalogu aparatu Unity. Zobacz Płytkie klonowanie tabel wykazu aparatu Unity.

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ślona tabela, zostanie zamieniona, jeśli istnieje i nowo utworzona, jeśli nie. table_name Bez CREATE OR musi istnieć.

• table_name

  Nazwa tabeli usługi Delta Lake do utworzenia. Nazwa nie może zawierać specyfikacji czasowej. 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 LUB KLON GŁĘBOKI

  Jeśli określisz usługę SHALLOW CLONE Azure Databricks, utworzysz kopię definicji tabeli źródłowej, ale odwołujesz się do plików tabeli źródłowej. Po określeniu DEEP CLONE (domyślnej) 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ą.

• 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 sama ścieżka 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.