Snowflake · Schema

IcebergTable

A Snowflake iceberg table

DataData WarehouseData LakehouseCloud Data PlatformAnalyticsArtificial IntelligenceData EngineeringData GovernanceSQLApache IcebergModel Context ProtocolT1

Properties

Name Type Description
name string Name of the iceberg table
comment string user comment associated to an object in the dictionary
change_tracking boolean True if change tracking is enabled, allowing streams and CHANGES to be used on the entity.
max_data_extension_time_in_days integer Maximum number of days to extend data retention beyond the retention period to prevent a stream becoming stale.
external_volume string Name of an external volume that will be used for persisted Iceberg metadata and data files.
data_retention_time_in_days integer number of days to retain the old version of deleted/updated data
catalog_sync string Name of the catalog integration to sync this table
catalog string Name of the catalog integration to use for iceberg tables
storage_serialization_policy string Storage serialization policy used for managed Iceberg table. This include encodings and compressions
created_on string Date and time when the iceberg table was created.
database_name string Database in which the iceberg table is stored
schema_name string Schema in which the iceberg table is stored
owner string Role that owns the iceberg table
owner_role_type string The type of role that owns the iceberg table
iceberg_table_type string Type of Iceberg table. UNMANAGED if the table is not managed by Snowflake. NOT ICEBERG otherwise.
catalog_table_name string Name of the table as recognized by the catalog.
catalog_namespace string Catalog namespace for the table. The namespace defined when the table was created. Otherwise, the default namespace associated with the catalog integration used by the table. If you’re syncing the tab
can_write_metadata string Signifies whether Snowflake can write metadata to the location specified by the file_path.
cluster_by array Specifies one or more columns or column expressions in the table as the clustering key.
columns array
base_location string The path to a directory where Snowflake can write data and metadata files for the table.
replace_invalid_characters boolean Specifies whether to replace invalid characters in the column names
auto_refresh boolean Specifies whether to automatically refresh the table metadata
metadata_file_path string Specifies the relative path of the Iceberg metadata file to use for column definitions.
constraints array
View JSON Schema on GitHub

JSON Schema

iceberg-table-iceberg-table-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "IcebergTable",
  "type": "object",
  "description": "A Snowflake iceberg table",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the iceberg table"
    },
    "comment": {
      "type": "string",
      "description": "user comment associated to an object in the dictionary"
    },
    "change_tracking": {
      "type": "boolean",
      "description": "True if change tracking is enabled, allowing streams and CHANGES to be used on the entity."
    },
    "max_data_extension_time_in_days": {
      "type": "integer",
      "description": "Maximum number of days to extend data retention beyond the retention period to prevent a stream becoming stale."
    },
    "external_volume": {
      "type": "string",
      "description": "Name of an external volume that will be used for persisted Iceberg metadata and data files."
    },
    "data_retention_time_in_days": {
      "type": "integer",
      "description": "number of days to retain the old version of deleted/updated data"
    },
    "catalog_sync": {
      "type": "string",
      "description": "Name of the catalog integration to sync this table"
    },
    "catalog": {
      "type": "string",
      "description": "Name of the catalog integration to use for iceberg tables"
    },
    "storage_serialization_policy": {
      "type": "string",
      "description": "Storage serialization policy used for managed Iceberg table. This include encodings and compressions"
    },
    "created_on": {
      "type": "string",
      "description": "Date and time when the iceberg table was created."
    },
    "database_name": {
      "type": "string",
      "description": "Database in which the iceberg table is stored"
    },
    "schema_name": {
      "type": "string",
      "description": "Schema in which the iceberg table is stored"
    },
    "owner": {
      "type": "string",
      "description": "Role that owns the iceberg table"
    },
    "owner_role_type": {
      "type": "string",
      "description": "The type of role that owns the iceberg table"
    },
    "iceberg_table_type": {
      "type": "string",
      "description": "Type of Iceberg table. UNMANAGED if the table is not managed by Snowflake. NOT ICEBERG otherwise."
    },
    "catalog_table_name": {
      "type": "string",
      "description": "Name of the table as recognized by the catalog."
    },
    "catalog_namespace": {
      "type": "string",
      "description": "Catalog namespace for the table. The namespace defined when the table was created. Otherwise, the default namespace associated with the catalog integration used by the table. If you\u2019re syncing the table to Snowflake Open Catalog, the default is null."
    },
    "can_write_metadata": {
      "type": "string",
      "description": "Signifies whether Snowflake can write metadata to the location specified by the file_path."
    },
    "cluster_by": {
      "type": "array",
      "description": "Specifies one or more columns or column expressions in the table as the clustering key."
    },
    "columns": {
      "type": "array"
    },
    "base_location": {
      "type": "string",
      "description": "The path to a directory where Snowflake can write data and metadata files for the table."
    },
    "replace_invalid_characters": {
      "type": "boolean",
      "description": "Specifies whether to replace invalid characters in the column names"
    },
    "auto_refresh": {
      "type": "boolean",
      "description": "Specifies whether to automatically refresh the table metadata"
    },
    "metadata_file_path": {
      "type": "string",
      "description": "Specifies the relative path of the Iceberg metadata file to use for column definitions."
    },
    "constraints": {
      "type": "array"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/iceberg-table-iceberg-table"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.