Static table settings

The Settings tab of a Static table is where you deploy it, read its statistics and drop its stored data. The tabs across the top of the table are Static, Preview, Dependants and Settings; the table's setup lives on the Static tab.

When the table is not saved or deployed

The Settings tab fills in only after the table is saved and deployed. Until then it explains what is missing.

Nothing loads on the tab until the table is deployed: no statistics appear, and the Preview tab stays disabled until you deploy.

Deploy the table

Deploying creates the table in the warehouse with your current column configuration.

  1. Open the table and go to Settings.
  2. Click Deploy in the banner at the top of the tab. The label reads Deploying while the deploy runs.
  3. Read the result.
You seeWhat it means
Static table deployed successfully, with "The static table has been deployed to the warehouse"The table is in the warehouse. The statistics start loading, and Preview opens.
Static table partially deployedOnly part of the deployment succeeded. The reason under the title describes the first failure.
Static table deployment failed, with "The static table could not be deployed."The table was not deployed. Read the message, fix the problem, then click Deploy again.

A Static table needs at least one column marked PK before it can deploy; see Static table columns. Troubleshooting lists the messages that can stop a deployment. Once the table is deployed, its Preview tab opens as well; see Preview table data.

Read the statistics

The strip titled Static Table Statistics sits above Table Management. Three cards summarise the stored table:

A card shows - while its value is not available. Click Refresh to reload the numbers.

Drop the stored data

Drop removes the table's stored data and keeps its definition, so you can deploy it again into an empty table. The action sits in the statistics strip and appears only while the table is deployed.

  1. Open Settings and click Drop.
  2. Read the confirmation, headed Drop this table from ClickHouse?. It states:
    • "All data is permanently deleted."
    • "The definition stays, so you can deploy again."
    • "Anything that depends on it is not dropped and will break until you fix it or redeploy the table."
  3. Click Drop table to confirm. A successful drop closes the dialog and confirms with Table dropped from ClickHouse, or with the message the server sends.

After a drop the table is no longer deployed: it shows Pending in the tree again, Settings asks you to deploy it, and Preview stays disabled until you deploy it once more. If the drop fails, a message says what happened, and the dialog stays open so you can try again.

Dropping does not change the table's columns. See Static table columns for the rules that apply to the primary key and the table's other flags.

Warning

A drop cannot be undone. The stored rows are removed for good, and the table starts empty when it is deployed again.

Before you drop, open the Dependants tab to see what uses the table; Dependencies and dependants explains the list. Deploy, run, truncate and monitor tables covers the wider day-to-day actions.

Return to the wizard

Table Management sits under the statistics strip. Its Open General step link takes you back to the Static tab, on its General step, where the table's name, description, logical models and permission groups are set.

Questions, answered

Why does Settings read "Static Table Not Created"?

The table has not been saved yet. The line under the title reads Please save the static table first to view settings. Save the table first, then open Settings again.

Why does Settings say "Static Table Not Deployed"?

The table is saved but not yet in the warehouse. Click Deploy in the banner at the top of the tab. Until the table is deployed, no statistics appear here.

What does "Static table partially deployed" mean?

Only part of the deployment succeeded. The reason under the title describes the first failure. Read it, fix the problem, then click Deploy again.

Can I deploy the table again after a drop?

Yes. A drop keeps the table's definition, so the Deploy banner returns and you can deploy it again. The table starts empty; fill it from its Data Mapping step.

Is dropping the same as deleting the table?

No. Drop removes the stored data and keeps the table's definition, so the table stays in place and can be deployed again. Deleting removes the table itself; see Deploy, run, truncate and monitor tables.

What happens to the objects that depend on the table when I drop it?

They are not dropped. They break until you fix them or deploy the table again. Check the Dependants tab before you drop; see Dependencies and dependants.

Why is the Preview tab disabled again after a drop?

Preview needs a deployed table, and a drop removes the stored table from the warehouse, so the tab disables again, with the tooltip Table must be deployed to preview data. Deploy the table again to reopen it.

Why does a statistics card show a dash?

The value is not available yet. Click Refresh to reload the numbers.

How do I get back to the General step from Settings?

Click Open General step under Table Management. It opens the Static tab on the General step.