Data Contract CLI Files

[1.0.17] - 2026-08-01

Deprecated

• DATAMESH_MANAGER_API_KEY, DATAMESH_MANAGER_HOST, DATACONTRACT_MANAGER_API_KEY, and DATACONTRACT_MANAGER_HOST (and the matching Config fields): use ENTROPY_DATA_API_KEY and ENTROPY_DATA_HOST instead

Added

• datacontract export html fits to datacontract-editor visualization
• datacontract test --filter and --filters test only the rows matching a SQL predicate, e.g., the latest partition; also available as filter/filters query parameters on the API server's POST /test (#1463)
• Credentials and connection options can be passed programmatically via DataContract(config=...) and DataContract.import_from_source(..., config=...), using the typed datacontract.Config class or a dict keyed by the environment variable names
• The API server accepts per-request credentials on POST /test via datacontract-* headers (e.g. datacontract-snowflake-password)
• Credentials and connection options can be provided in a YAML config file, via --config-file (defaults to ./datacontract-config.yaml or ~/.datacontract/config.yaml) or Config.from_yaml(), with ${VAR} references resolved from the environment
• New Snowflake connection options: DATACONTRACT_SNOWFLAKE_TOKEN, DATACONTRACT_SNOWFLAKE_PASSCODE, DATACONTRACT_SNOWFLAKE_PRIVATE_KEY, DATACONTRACT_SNOWFLAKE_NETWORK_TIMEOUT, DATACONTRACT_SNOWFLAKE_SOCKET_TIMEOUT, DATACONTRACT_SNOWFLAKE_HOST, DATACONTRACT_SNOWFLAKE_PORT
• Config options to override the server details from the data contract (host, port, database, schema, catalog, project, dataset, account, service name, staging directory) for Postgres, MySQL, SQL Server, Oracle, Redshift, Snowflake, BigQuery, Databricks, Trino, Athena, and Impala, e.g. DATACONTRACT_POSTGRES_HOST (#1076)
• Data contract locations now support s3:// URLs for commands that read contracts, including lint, test, export, publish, changelog, and ci

Changed

• datacontract test against Snowflake only forwards the documented DATACONTRACT_SNOWFLAKE_* options to the connector; unknown variables are ignored with a warning
• DATACONTRACT_SNOWFLAKE_ACCOUNT overrides the contract's account instead of being ignored with a warning
• DATACONTRACT_DATABRICKS_SERVER_HOSTNAME overrides the contract's host; previously the contract value won when both were set

Fixed

• datacontract dbt sync writes a description on all dbt tests, not only newly-generated ones