Skip to main content
Version: 0.4 (Latest)

Databricks Reference

Reference material for Databricks Publishing -- data type mappings, CLI arguments, and querying.

Data Type Mapping​

Source types map automatically to Databricks-compatible types. LakeXpress exports through Parquet, so the mapping is driven by the normalized source type name.

Pick your source database:

PostgreSQL to Databricks​

PostgreSQL TypeDatabricks Type
SMALLINTSMALLINT
INTEGER, INT4INT
BIGINT, INT8BIGINT
NUMERIC(p,s)DECIMAL(p,s)
REAL, FLOAT4FLOAT
DOUBLE PRECISION, FLOAT8DOUBLE
VARCHAR(n)VARCHAR(n)
TEXT, TIME, UUID, JSON, JSONB, array []STRING
CHAR(n)CHAR(n)
BOOLEANBOOLEAN
DATEDATE
TIMESTAMPTIMESTAMP_NTZ
TIMESTAMPTZTIMESTAMP
BYTEABINARY

CLI Reference​

Databricks Publishing Arguments​

OptionTypeDescription
--publish_target IDStringCredential ID for Databricks publishing (required)
--publish_schema_pattern PATTERNStringSchema naming pattern (default: EXT_{schema} for external, {schema} for internal)
--publish_table_pattern PATTERNStringTable naming pattern (default: {table})
--publish_method {external,internal}Enumexternal (Unity Catalog external table) or internal (managed Delta table) (default: external)
--pk_constraintsFlagAdd PRIMARY KEY constraints (managed/Delta tables only)
--n_jobs NIntegerParallel workers for table creation (default: 1)

There is no --databricks_catalog flag. The target catalog is always taken from the catalog field of the Databricks credential in credentials.json.

Deprecated / Renamed Arguments​

Old ArgumentCurrent ArgumentNotes
--databricks_table_type--publish_method {external|internal}Renamed to the generic, cross-platform flag (internal maps to managed for Databricks)
--databricks_catalog(none)Never implemented as a CLI flag; the catalog comes from credentials only

Querying Tables​

Databricks SQL:

SELECT * FROM lakexpress_catalog.tpch_1.customer LIMIT 10;

Databricks Notebooks (Python):

df = spark.table("lakexpress_catalog.tpch_1.customer")
df.display()

Databricks Notebooks (SQL):

%sql
SELECT * FROM lakexpress_catalog.tpch_1.customer LIMIT 10

Delta Table Features (Managed Tables Only)​

Time Travel:

SELECT * FROM lakexpress_catalog.tpch_1.customer VERSION AS OF 1;

Table History:

DESCRIBE HISTORY lakexpress_catalog.tpch_1.customer;

Optimize:

OPTIMIZE lakexpress_catalog.tpch_1.customer;

See Also​

Copyright © 2026 Architecture & Performance.