Table

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/Table",
  "title": "Table",
  "type": "object",
  "description": "A Snowflake table",
  "properties": {
    "name": {
      "type": "string",
      "description": "Specifies the name for the table, must be unique for the schema in which the table is created",
      "example": "Example Title"
    },
    "kind": {
      "type": "string",
      "enum": [
        "PERMANENT",
        "TRANSIENT",
        "TEMPORARY",
        "",
        "transient",
        "temporary"
      ],
      "x-enum-varnames": [
        "PERMANENT",
        "TRANSIENT",
        "TEMPORARY",
        "DEPRECATED_PERMANENT",
        "DEPRECATED_TRANSIENT",
        "DEPRECATED_TEMPORARY"
      ],
      "default": "PERMANENT",
      "description": "Table type - permanent, transient, or temporary",
      "example": "PERMANENT"
    },
    "cluster_by": {
      "type": "array",
      "description": "Specifies one or more columns or column expressions in the table as the clustering key",
      "items": {
        "type": "string"
      },
      "example": []
    },
    "enable_schema_evolution": {
      "type": "boolean",
      "description": "Table has schema evolution enabled or disabled",
      "example": true
    },
    "change_tracking": {
      "type": "boolean",
      "description": "Change tracking is enabled or disabled",
      "example": true
    },
    "data_retention_time_in_days": {
      "type": "integer",
      "description": "Specifies the retention period for the table so that Time Travel actions SELECT, CLONE, UNDROP can be performed on historical data in the table",
      "example": 10
    },
    "max_data_extension_time_in_days": {
      "type": "integer",
      "description": "Specifies the retention period for the table so that Time Travel actions SELECT, CLONE, UNDROP can be performed on historical data in the table",
      "example": 10
    },
    "default_ddl_collation": {
      "type": "string",
      "description": "Specifies a default collation specification for the columns in the table, including columns added to the table in the future",
      "example": "example_value"
    },
    "columns": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/TableColumn"
      },
      "example": []
    },
    "constraints": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Constraint"
      },
      "example": []
    },
    "comment": {
      "type": "string",
      "description": "Comment for the table",
      "example": "example_value"
    },
    "created_on": {
      "type": "string",
      "format": "date-time",
      "readOnly": true,
      "description": "Date and time when the table was created.",
      "example": "2026-01-15T10:30:00Z"
    },
    "database_name": {
      "type": "string",
      "readOnly": true,
      "description": "Database in which the table is stored",
      "example": "example_value"
    },
    "schema_name": {
      "type": "string",
      "readOnly": true,
      "description": "Schema in which the table is stored",
      "example": "example_value"
    },
    "rows": {
      "type": "integer",
      "format": "int64",
      "readOnly": true,
      "description": "Number of rows in the table. Returns NULL for external tables.",
      "example": 10
    },
    "bytes": {
      "type": "integer",
      "format": "int64",
      "readOnly": true,
      "description": "Number of bytes that will be scanned if the entire table is scanned in a query. Note that this number may be different than the number of actual physical bytes stored on-disk for the table",
      "example": 10
    },
    "owner": {
      "type": "string",
      "readOnly": true,
      "description": "Role that owns the table",
      "example": "example_value"
    },
    "dropped_on": {
      "type": "string",
      "format": "date-time",
      "readOnly": true,
      "description": "Date and time when the table was dropped",
      "example": "2026-01-15T10:30:00Z"
    },
    "automatic_clustering": {
      "type": "boolean",
      "readOnly": true,
      "description": "If Automatic Clustering is enabled for your account, specifies whether it is explicitly enabled or disabled for the table.",
      "example": true
    },
    "search_optimization": {
      "type": "boolean",
      "readOnly": true,
      "description": "If ON, the table has the search optimization service enabled",
      "example": true
    },
    "search_optimization_progress": {
      "type": "integer",
      "format": "int64",
      "readOnly": true,
      "description": "Percentage of the table that has been optimized for search.",
      "example": 10
    },
    "search_optimization_bytes": {
      "type": "integer",
      "format": "int64",
      "readOnly": true,
      "description": "Number of additional bytes of storage that the search optimization service consumes for this table",
      "example": 10
    },
    "owner_role_type": {
      "type": "string",
      "readOnly": true,
      "description": "The type of role that owns the object.",
      "example": "example_value"
    },
    "budget": {
      "type": "string",
      "readOnly": true,
      "description": "Name of the budget if the object is monitored by a budget",
      "example": "example_value"
    },
    "table_type": {
      "type": "string",
      "enum": [
        "NORMAL",
        "DYNAMIC",
        "EXTERNAL",
        "EVENT",
        "HYBRID",
        "ICEBERG",
        "IMMUTABLE"
      ],
      "readOnly": true,
      "description": "Type of the table",
      "example": "NORMAL"
    }
  },
  "required": [
    "name"
  ]
}