CREATE TABLE CLONE

Se aplica a:check marked yes Databricks SQL check marked yes Databricks Runtime

Clona una tabla Delta de origen en un destino en una versión específica. Un clon puede ser profundo o superficial. Los clones profundos crean copias de los datos del origen, al contrario que los superficiales. También puede clonar tablas fuente Parquet e Iceberg. Consulte Clonación incremental de tablas de Parquet e Iceberg en Delta Lake.

En Databricks SQL y Databricks Runtime 13.1 y versiones posteriores, puede usar un clon superficial con tablas administradas por Unity Catalog. En Databricks Runtime 13.0 y versiones posteriores, no hay compatibilidad con clones superficiales en Unity Catalog. Consulte Clonación superficial para tablas de Unity Catalog.

Importante

Existen diferencias notables entre los clones profundos y los superficiales, lo que puede determinar la manera más adecuada de usarlos. Consulte Clonación de una tabla en Azure Databricks.

Sintaxis

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]

Parámetros

  • IF NOT EXISTS

    En caso de que esté especificado, se omite la instrucción si ya existe table_name.

  • [CREATE OR] REPLACE

    Cuando se especifica CREATE OR, la tabla se reemplaza, si existe y, si no, se crea de nuevo. Sin CREATE OR, debe existir table_name.

  • table_name

    El nombre de la tabla de Delta Lake que va a crearse. El nombre no debe incluir una especificación temporal. Si el nombre no está completo, la tabla se crea en el esquema actual. Ya no debería existir table_name, a no ser que se hayan especificado REPLACE o IF NOT EXISTS.

  • CLONACIÓN SUPERFICIAL o CLONACIÓN PROFUNDA

    Si especifica SHALLOW CLONE, Azure Databricks realizará una copia de la definición de la tabla de origen, pero remite a los archivos de la tabla de origen. Al especificarse DEEP CLONE (valor predeterminado), Azure Databricks hará una copia completa e independiente de la tabla de origen.

  • source_table_name

    El nombre de la tabla de Delta Lake que va a clonarse. El nombre puede incluir una especificación temporal.

  • TBLPROPERTIES

    Este parámetro opcional le permite establecer una o varias propiedades definidas por el usuario.

  • LOCATION path

    Crea, de forma opcional, una tabla externa, con la localización proporcionada como ruta de acceso, en la que se almacenan los datos. Si table_name es una ruta de acceso y no un identificador de tabla, se producirá un error en la operación. path debe ser un literal de cadena.

Ejemplos

Puedes usar CREATE TABLE CLONE para operaciones complejas como migración de datos, archivo de datos, reproducción de flujo de aprendizaje automático, experimentos a corto plazo y uso compartido de datos. Consulte Clonación de una tabla en Azure Databricks.