atoti_directquery_databricks.table_options module

class atoti_directquery_databricks.DatabricksTableOptions

__init__(*, clustering_columns=(), keys=None)

Additional options about the external table to create.

Parameters:

• clustering_columns (Sequence[str]) –

  The names of the columns used for clustering.

  Feeding aggregate providers from an external database can result in very large queries to be run on this database. Clustering columns split up queries made by DirectQuery to the external database when feeding aggregate providers.

• keys (Sequence[str] | None) –

  The columns that will become keys of the table.

  Inserting a row containing key values equal to the ones of an existing row will replace the existing row with the new one.

  Key columns cannot have None as their default_value.

Example

>>> from atoti_directquery_databricks import (
...     DatabricksTableOptions,
... )
>>> external_table = external_database.tables["tutorial", "sales"]
>>> table = session.add_external_table(
...     external_table,
...     table_name="sales_renamed",
...     options=DatabricksTableOptions(keys=["SALE_ID"]),
... )