Udostępnij za pomocą

CREATE TABLE LIKE

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

Definiuje tabelę przy użyciu definicji i metadanych istniejącej tabeli.

Usługa Delta Lake obsługuje usługi CREATE TABLE LIKE Databricks SQL i Databricks Runtime 13.3 LTS i nowsze. W wersjach Databricks Runtime 12.2 LTS i wcześniejszych użyj CREATE TABLE jako.

Składnia

CREATE TABLE [ IF NOT EXISTS ] table_name LIKE source_table_name [table_clauses]

table_clauses
   { USING data_source |
     LOCATION path |
     TBLPROPERTIES clause |
     ROW FORMAT row_format |
     STORED AS file_format } [...]

row_format
   { SERDE serde_class [ WITH SERDEPROPERTIES (serde_key = serde_val [, ...] ) ] |
     { DELIMITED [ FIELDS TERMINATED BY fields_terminated_char [ ESCAPED BY escaped_char ] ]
       [ COLLECTION ITEMS TERMINATED BY collection_items_terminated_char ]
       [ MAP KEYS TERMINATED BY map_key_terminated_char ]
       [ LINES TERMINATED BY row_terminated_char ]
       [ NULL DEFINED AS null_char ] } }

property_key
  { identifier [. ...] | string_literal }

Parametry

  • JEŚLI NIE ISTNIEJE

    Jeśli określono, ignoruje instrukcję , jeśli table_name już istnieje.

  • table_name

    Nazwa tabeli 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 jeszcze istnieć.

  • source_table_name

    Nazwa tabeli, której definicja jest kopiowana. source_table_name i table_name muszą znajdować się albo w magazynie metadanych Hive, albo w katalogu Unity.

  • table_clauses

    Opcjonalnie określ format źródła danych, lokalizację i właściwości zdefiniowane przez użytkownika dla nowej tabeli. Każda klauzula podrzędna może być określona tylko raz.

    • ŚCIEŻKA LOKALIZACJI

      Ścieżka do katalogu, w którym są przechowywane dane tabeli, co może być ścieżką w magazynie rozproszonym. Jeśli określisz lokalizację, nowa tabela stanie się tabelą zewnętrzną . Jeśli nie określisz lokalizacji, tabela jest tabelą zarządzaną .

      Nie można tworzyć tabel zewnętrznych w lokalizacjach nakładających się na lokalizację zarządzanych tabel.

    • TBLPROPERTIES

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

    • UŻYWANIE data_source

      Format pliku do użycia dla tabeli. data_source musi być jednym z:

      • TEXT
      • CSV
      • JSON
      • JDBC
      • PARQUET
      • DELTA

      Następujące dodatkowe formaty plików do użycia w tabeli są obsługiwane w środowisku Databricks Runtime:

      • ORC
      • HIVE
      • LIBSVM
      • w pełni kwalifikowana nazwa klasy niestandardowej implementacji org.apache.spark.sql.sources.DataSourceRegister.

      Jeśli nie określisz USING format tabeli źródłowej będzie dziedziczony.

      Dotyczy to następujących elementów: Databricks Runtime

      HIVE jest obsługiwany w celu utworzenia tabeli Hive SerDe w środowisku Databricks Runtime. Można określić specyficzne dla file_format programu Hive i row_format użyć OPTIONS klauzuli , która jest mapą ciągów bez uwzględniania wielkości liter. Oto option_keys :

      • FILEFORMAT
      • INPUTFORMAT
      • OUTPUTFORMAT
      • SERDE
      • FIELDDELIM
      • ESCAPEDELIM
      • MAPKEYDELIM
      • LINEDELIM

    • ROW_FORMAT FORMAT WIERSZA

      Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks Runtime

      Aby określić niestandardową SerDe, ustaw wartość na SERDE i określ w pełni kwalifikowaną nazwę klasy niestandardowej SerDe oraz opcjonalne właściwości SerDe. Aby użyć natywnej funkcji SerDe, ustaw wartość na DELIMITED i określ ogranicznik, znak ucieczki, znak null itd.

      • SERDEPROPERTIES

        Lista par klucz-wartość używana do tagowania definicji SerDe.

      • POLA ZAKOŃCZONE PRZEZ

        Zdefiniuj separator kolumny.

      • UCIECZKA PRZEZ

        Zdefiniuj mechanizm ucieczki.

      • ELEMENTY KOLEKCJI ZAKOŃCZONE PRZEZ

        Zdefiniuj separator elementu kolekcji.

      • MAPUJ KLUCZE ZAKOŃCZONE PRZEZ

        Zdefiniuj separator klucza mapy.

      • WIERSZE ZAKOŃCZONE PRZEZ

        Zdefiniuj separator wierszy.

      • WARTOŚĆ NULL ZDEFINIOWANA JAKO

        Zdefiniuj konkretną wartość dla elementu NULL.

      • PRZECHOWYWANE JAKO

        Format pliku tabeli. Dostępne formaty obejmują TEXTFILE, , SEQUENCEFILE, RCFILEORC, PARQUET, i AVRO. Alternatywnie można określić własne formaty wejściowe i wyjściowe za pomocą poleceń INPUTFORMAT i OUTPUTFORMAT. Tylko formaty TEXTFILE, SEQUENCEFILEi RCFILE mogą być używane tylko z parametrami ROW FORMAT SERDE i można ich używać tylko TEXTFILE w programie ROW FORMAT DELIMITED.

Uwagi

W zależności od źródła danych i elementu docelowego nie wszystkie właściwości tabel mogą być przenoszone.

CREATE TABLE LIKE, gdy źródło jest tabelą Delta Lake:

Funkcja/właściwość Element docelowy nie jest tabelą delta Cel to tabela delta
KOMENTARZ Tak Tak
Kolumny Tak Tak
Partycjonowanie kolumn Tak Tak
Konfigurowanie Nie. Tak
Ograniczenie tabeli Nie dotyczy Tak
Protokół delta Nie dotyczy Tak

CREATE TABLE LIKE, gdy źródło nie jest tabelą Delta Lake:

Funkcja/właściwość Element docelowy nie jest tabelą delta Cel to tabela delta
KOMENTARZ Tak Tak
Kolumny Tak Tak
Partycjonowanie kolumn Tak Tak
Konfigurowanie Tak Tak
Ograniczenie tabeli Nie. Tak
Protokół delta Nie (bieżący protokół domyślny dla tej sesji) Tak

Przykłady

-- Create table using a new location
> CREATE TABLE Student_Dupli LIKE Student LOCATION '/path/to/data_files';

-- Create table like using a data source
> CREATE TABLE Student_Dupli LIKE Student USING CSV LOCATION '/path/to/csv_files';
  • Last updated on