CREATE TABLE LIKE

Aplica-se a: SQL do Databricks Databricks Runtime

Define uma tabela usando a definição e os metadados de uma tabela existente.

O Delta Lake dá suporte a CREATE TABLE LIKE no Databricks SQL e Databricks Runtime 13.3 LTS e versões superiores. Na versão Databricks Runtime 12.2 LTS ou anteriores, use CREATE TABLE AS.

Sintaxe

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 }

Parâmetros

• SE NÃO EXISTIR

  Se especificado, ignorará a instrução se o table_name já existir.

• table_name

  O nome da tabela a ser criada. O nome não deve incluir uma especificação temporal ou especificação de opções. Se o nome não for qualificado, a tabela será criada no esquema atual. Um table_name não deve existir ainda.

• source_table_name

  O nome da tabela cuja definição é copiada. source_table_name e table_name devem estar no metastore do Hive ou estar no Catálogo do Unity.

• table_clauses

  Opcionalmente, especifique um formato de fonte de dados, um local e propriedades definidas pelo usuário para a nova tabela. Cada subcláusula só pode ser especificada uma vez.

  • caminho LOCATION

    Um caminho para o diretório onde os dados da tabela estão armazenados, que pode ser um caminho no armazenamento distribuído. Se você especificar um local, a nova tabela se tornará uma tabela externa. Se você não especificar um local, a tabela será uma tabela gerenciada.

    Não é possível criar tabelas externas em locais que se sobreponham ao local das tabelas gerenciadas.

  • TBLPROPERTIES

    Opcionalmente, define uma ou mais propriedades definidas pelo usuário.

  • USANDO fonte_de_dados

    O formato de arquivo a ser usado para a tabela. data_source deve ser um destes:

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

    Os seguintes formatos de arquivo adicionais a serem usados para a tabela têm suporte no Databricks Runtime:

    • ORC
    • HIVE
    • LIBSVM
    • O nome de classe totalmente qualificado de uma implementação de org.apache.spark.sql.sources.DataSourceRegister personalizada.

    Se você não especificar o USING formato da tabela de origem, será herdado.

    O seguinte se aplica ao: Databricks Runtime

    HIVE tem suporte para criar uma tabela SerDe do Hive no Databricks Runtime. Você pode especificar file_format e row_format específicos do Hive usando a cláusula OPTIONS, que é um mapa de cadeia de caracteres que não diferencia maiúsculas e minúsculas. Os option_keys são:

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

  • FORMATO DE LINHA ROW_FORMAT

    Aplica-se a: Databricks Runtime

    Para especificar um SerDe personalizado, defina como SERDE e especifique o nome de classe totalmente qualificado de um SerDe personalizado e propriedades de SerDe opcionais. Para usar o SerDe nativo, defina como DELIMITED e especifique o delimitador, o caractere de escape, o caractere nulo etc.

    • SERDEPROPERTIES

      Uma lista de pares chave-valor usados para marcar a definição de SerDe.

    • CAMPOS ENCERRADOS POR

      Usado para definir um separador de coluna.

    • ESCAPE POR

      Defina o mecanismo de escape.

    • ITENS DE COLEÇÃO ENCERRADOS POR

      Defina um separador de item de coleção.

    • CHAVES DE MAPA TERMINADAS POR

      Defina um separador de chave de mapa.

    • LINHAS ENCERRADAS POR

      Defina um separador de linha.

    • NULL DEFINIDO COMO

      Defina o valor específico para NULL.

    • ARMAZENADO COMO

      O formato de arquivo para a tabela. Os formatos disponíveis incluem TEXTFILE, SEQUENCEFILE, RCFILE, ORC, PARQUET e AVRO. Como alternativa, você pode especificar seus próprios formatos de entrada e saída por meio de INPUTFORMAT e OUTPUTFORMAT. Somente os formatos TEXTFILE, SEQUENCEFILE e RCFILE podem ser usados com ROW FORMAT SERDE e somente TEXTFILE podem ser usado com ROW FORMAT DELIMITED.

Observações

Dependendo da fonte de dados e do destino, nem todas as propriedades das tabelas podem ser transferidas.

CREATE TABLE LIKE quando a origem é uma tabela do Delta Lake:

CREATE TABLE LIKE quando a origem não é uma tabela do Delta Lake:

Exemplos

-- 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';

Artigos relacionados

• CREATE TABLE [USANDO]
• CREATE TABLE CLONE
• DROP TABLE
• ALTER TABLE
• Propriedades da tabela