Skip to content
Open console

Enter a topic to search documentation.

    Resource schemas

    Generated fields and validation rules for databricks workspace resources.

    Compatibility and access

    Generated from product commit 6f341b4e6d35 . This is a source snapshot, not a guarantee that your deployment runs this version.

    These resource schemas describe provider configuration. Check your deployed API discovery for the schema installed in your hub. Use the intended workspace context and an identity permitted to read or change the resource. Required fields below are required within their containing object; optional parent objects may be omitted.

    Download complete schemas , including nested validation rules and status definitions. This page covers Kubernetes-style resources; provider HTTP actions and runtime behavior are separate contracts. Return to API reference for those interfaces and related guides.

    Connection (v1alpha1)

    API: databricks.faros.sh/v1alpha1 · Resource: connections · Scope: Cluster

    Source schema

    Terminal
    kubectl explain connections.databricks.faros.sh --api-version=databricks.faros.sh/v1alpha1 --recursive

    FieldTypeRequired in parentDescription and constraints
    specobjectYesNo description supplied by the source schema.
    spec.authTypestringYesAuthType selects the credential model. PAT is the only supported model. enum: [“pat”]
    spec.hoststringYesHost is the Databricks workspace host, e.g. https://dbc-xyz.cloud.databricks.com . minLength: 1; maxLength: 2048; pattern: “^https://[A-Za-z0-9.-]+(:[0-9]+)?/?$”
    spec.secretRefobjectYesSecretRef points at tenant workspace credential/federation config.
    spec.secretRef.keystringNoKey is the optional key holding credential material. Defaults depend on the auth type.
    spec.secretRef.namestringYesName is the Secret name in the tenant workspace. minLength: 1
    spec.secretRef.namespacestringNoNamespace is the Secret namespace in the tenant workspace. Defaults to default.
    statusobjectNoNo description supplied by the source schema.
    status.conditionsarray[object]NoNo description supplied by the source schema.
    status.conditions[].lastTransitionTimestringYeslastTransitionTime is the last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
    status.conditions[].messagestringYesmessage is a human readable message indicating details about the transition. This may be an empty string. maxLength: 32768
    status.conditions[].observedGenerationintegerNoobservedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance. minimum: 0
    status.conditions[].reasonstringYesreason contains a programmatic identifier indicating the reason for the condition’s last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty. minLength: 1; maxLength: 1024; pattern: “^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$”
    status.conditions[].statusstringYesstatus of the condition, one of True, False, Unknown. enum: [“True”, “False”, “Unknown”]
    status.conditions[].typestringYestype of condition in CamelCase or in foo.example.com/CamelCase. maxLength: 316; pattern: “^([a-z0-9]([-a-z0-9][a-z0-9])?(\\.[a-z0-9]([-a-z0-9][a-z0-9])?)/)?(([A-Za-z0-9][-A-Za-z0-9_.])?[A-Za-z0-9])$”
    status.observedGenerationintegerNoNo description supplied by the source schema.
    status.workspaceIDstringNoNo description supplied by the source schema.

    Table (v1alpha1)

    API: databricks.faros.sh/v1alpha1 · Resource: tables · Scope: Cluster

    Source schema

    Terminal
    kubectl explain tables.databricks.faros.sh --api-version=databricks.faros.sh/v1alpha1 --recursive

    FieldTypeRequired in parentDescription and constraints
    specobjectYesNo description supplied by the source schema.
    spec.catalogstringYesminLength: 1; maxLength: 255; pattern: “^[^\\p{Cc}]+$”
    spec.connectionRefstringYesminLength: 1; maxLength: 253
    spec.schemastringYesminLength: 1; maxLength: 255; pattern: “^[^\\p{Cc}]+$”
    spec.tablestringYesminLength: 1; maxLength: 255; pattern: “^[^\\p{Cc}]+$”
    spec.warehouseRefstringYesminLength: 1; maxLength: 253
    statusobjectNoNo description supplied by the source schema.
    status.columnsarray[object]NoColumns caches schema for App Studio authoring. It never stores row data. maxItems: 64
    status.columns[].commentstringNomaxLength: 4096
    status.columns[].namestringYesminLength: 1; maxLength: 255; pattern: “^[^\\p{Cc}]+$”
    status.columns[].nullablebooleanNoNo description supplied by the source schema.
    status.columns[].typestringYesminLength: 1; maxLength: 1024; pattern: “^[^\\p{Cc}]+$”
    status.conditionsarray[object]NoNo description supplied by the source schema.
    status.conditions[].lastTransitionTimestringYeslastTransitionTime is the last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
    status.conditions[].messagestringYesmessage is a human readable message indicating details about the transition. This may be an empty string. maxLength: 32768
    status.conditions[].observedGenerationintegerNoobservedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance. minimum: 0
    status.conditions[].reasonstringYesreason contains a programmatic identifier indicating the reason for the condition’s last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty. minLength: 1; maxLength: 1024; pattern: “^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$”
    status.conditions[].statusstringYesstatus of the condition, one of True, False, Unknown. enum: [“True”, “False”, “Unknown”]
    status.conditions[].typestringYestype of condition in CamelCase or in foo.example.com/CamelCase. maxLength: 316; pattern: “^([a-z0-9]([-a-z0-9][a-z0-9])?(\\.[a-z0-9]([-a-z0-9][a-z0-9])?)/)?(([A-Za-z0-9][-A-Za-z0-9_.])?[A-Za-z0-9])$”
    status.observedGenerationintegerNoNo description supplied by the source schema.
    status.refreshedAtstringNoNo description supplied by the source schema.

    Warehouse (v1alpha1)

    API: databricks.faros.sh/v1alpha1 · Resource: warehouses · Scope: Cluster

    Source schema

    Terminal
    kubectl explain warehouses.databricks.faros.sh --api-version=databricks.faros.sh/v1alpha1 --recursive

    FieldTypeRequired in parentDescription and constraints
    specobjectYesNo description supplied by the source schema.
    spec.connectionRefstringYesminLength: 1; maxLength: 253
    spec.warehouseIDstringYesminLength: 1; maxLength: 255; pattern: “^[^\\p{Cc}]+$”
    statusobjectNoNo description supplied by the source schema.
    status.conditionsarray[object]NoNo description supplied by the source schema.
    status.conditions[].lastTransitionTimestringYeslastTransitionTime is the last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
    status.conditions[].messagestringYesmessage is a human readable message indicating details about the transition. This may be an empty string. maxLength: 32768
    status.conditions[].observedGenerationintegerNoobservedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance. minimum: 0
    status.conditions[].reasonstringYesreason contains a programmatic identifier indicating the reason for the condition’s last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty. minLength: 1; maxLength: 1024; pattern: “^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$”
    status.conditions[].statusstringYesstatus of the condition, one of True, False, Unknown. enum: [“True”, “False”, “Unknown”]
    status.conditions[].typestringYestype of condition in CamelCase or in foo.example.com/CamelCase. maxLength: 316; pattern: “^([a-z0-9]([-a-z0-9][a-z0-9])?(\\.[a-z0-9]([-a-z0-9][a-z0-9])?)/)?(([A-Za-z0-9][-A-Za-z0-9_.])?[A-Za-z0-9])$”
    status.observedGenerationintegerNoNo description supplied by the source schema.
    status.statestringNoNo description supplied by the source schema.