Skip to main content
POST
Start a Databricks Metric View publication preview
Queues an offline conversion of static YAML from the deployment’s latest successful build and returns polling URLs immediately. Exact retries while the same content-addressed preview is running reuse that work; a later submission starts a fresh execution. Preview payloads and results are retained for at most seven days. The conversion supports scalar dimensions, common and calculated measures, and acyclic many-to-one equi-joins from one Databricks datasource. Access policies, templating, extends, unsafe fanout, unsupported expressions, multiple datasources, and converter loss are blocked per view. Two-part schema.table sources are qualified with CUBEJS_DB_DATABRICKS_CATALOG for the selected datasource; without that setting they fail closed with an actionable issue. Requires SchemaRead or SchemaUpdate access. This is currently in preview — reach out to the Cube support team to activate it for your account.

Authorizations

Authorization
string
header
required

Token authentication. Send Authorization: Bearer <YOUR_TOKEN>.

Path Parameters

deploymentId
integer
required

Body

application/json

DatabricksMetricViewPublicationPreviewInput

dataSourceName
string
required
selectionMode
enum<string>
required
Available options:
all,
selected,
pattern
sourceOverrides
object | null

Optional map of Cube view name to the root source dataset the view projects from, for view projections where that root would otherwise be ambiguous.

targetNames
object | null

Optional Cube view name to Databricks Metric View name overrides.

viewNameRegex
string | null

A safe, bounded regex subset for view names. Supports literals, ^, $, dot, and one .* wildcard; grouping, alternation, lookaround, and backreferences are rejected.

viewNames
string[] | null

Required only when selectionMode is 'selected'.

Response

202 - application/json
buildJobId
integer
required
dataSourceName
string
required
deploymentId
integer
required
previewId
string
required
resultUrl
string
required
reused
boolean
required
status
enum<string>
required
Available options:
QUEUED
statusUrl
string
required
commit
string | null