Support

For official support and urgent, production-impacting issues, please contact Snowflake Support.

⚠️ Keep in mind that the official support starts with the v2.0.0 for stable resources only. All previous versions and preview resources are not officially supported.

Please follow creating issues guidelines, FAQ, and known issues before submitting an issue on GitHub or directly to Snowflake Support.

Snowflake Terraform Provider

⚠️ Please note: If you believe you have found a security issue, please responsibly disclose by contacting us at [email protected].

⚠️ Disclaimer: The project is in GA version, but some features are in preview. Such resources and data sources are considered preview features in the provider, regardless of their state in Snowflake. We do not guarantee their stability. They will be reworked and marked as a stable feature in future releases. Breaking changes in these features are expected, even without bumping the major version. They are disabled by default. To use them, add the relevant feature name to preview_features_enabled field in the provider configuration. The list of preview features is available below. Please always refer to the Getting Help section in our Github repo to best determine how to get help for your questions.

---

This is a terraform provider for managing Snowflake resources.

Table of contents

• Snowflake Terraform Provider
  • Table of contents
  • Getting started
  • Supported Architectures
  • Migration guide
  • Roadmap
  • Getting Help
  • Would you like to create an issue?
  • Additional SQL Client configuration
  • Contributing
  • Releases

Getting started

The current namespace of the provider in the Terraform Registry is snowflakedb.

If you're still using the chanzuckerberg/snowflake source, see Upgrading from CZI Provider to upgrade to the Snowflake-Labs namespace.

If you're still using the Snowflake-Labs/snowflake source, see Upgrading from Snowflake-Labs Provider to upgrade to the snowflakedb namespace.

Install the Snowflake Terraform provider by adding a requirement block and a provider block to your Terraform codebase:

terraform {
  required_providers {
    snowflake = {
      source  = "snowflakedb/snowflake"
      version = ">= 1.0.0"
    }
  }
}

provider "snowflake" {
  organization_name = "organization_name"
  account_name      = "account_name"
  user              = "johndoe"
  password          = var.password
  role              = "PUBLIC"
}

# Remember to provide the password securely.
variable "password" {
  type      = string
  sensitive = true
}

For more information on provider configuration see the provider docs on the Terraform registry.

Don't forget to run terraform init and you're ready to go! 🚀

Start browsing the registry docs to find resources and data sources to use.

Supported Architectures

We have compiled a list to clarify which binaries are officially supported and which are provided additionally but not officially supported. The lists are based on what the underlying gosnowflake driver supports and what HashiCorp recommends for Terraform providers.

The Snowflake Terraform provider supports the following architectures:

• Windows: amd64
• Linux: amd64 and arm64
• Darwin: amd64 and arm64

We also provide additional configurations, but they are not officially supported, and we do not prioritize fixes for them:

• Windows: arm64 and 386
• Linux: 386
• Darwin: 386
• Freebsd: any architecture

Migration guide

Please check the migration guide when changing the version of the provider.

Roadmap

Check Roadmap.

Getting Help

Some links that might help you:

• The introductory tutorial shows how to set up your Snowflake account for Terraform (service user, role, authentication, etc) and how to create your first resources in Terraform.
• The docs on the Terraform registry are a complete reference of all resources and data sources supported and contain more advanced examples.
• The discussions area of this repo, we use this forum to discuss new features and changes to the provider.
• If you are an enterprise customer, reach out to your account team. This helps us prioritize issues.
• The issues section might already have an issue addressing your question.

Would you like to create an issue?

If you would like to create a GitHub issue, please read our guide first. It contains useful links, FAQ, and commonly known issues with solutions that may already solve your case.

Additional SQL Client configuration

The provider uses the underlying gosnowflake driver to send SQL commands to Snowflake.

By default, the underlying driver is set to error level logging. It can be changed by setting driver_tracing field in the configuration to one of (from most to least verbose):

• trace
• debug
• info
• print
• warning
• error
• fatal
• panic

Read more in provider configuration docs.

Contributing

Check Contributing.

Releases

Releases will be performed as needed, typically once every 2 weeks.

Releases are published to the terraform registry. Each change has its own release notes (e.g. https://github.com/snowflakedb/terraform-provider-snowflake/releases/tag/v0.89.0) and migration guide if needed (e.g. https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/MIGRATION_GUIDE.md#v0880--v0890).