支持

若需要官方支持或紧急处理影响生产的问题，请联系 Snowflake 支持。

⚠️ 请记住，官方支持从 v2.0.0 版本开始，仅针对稳定资源。所有之前的版本和预览资源均不受官方支持。

在向 GitHub 或直接向 Snowflake 支持提交问题前，请遵循 创建问题指南、常见问题解答 和 已知问题。

Snowflake Terraform 提供者

⚠️ 请注意：如果您认为发现了安全问题，请通过联系 triage-terraformprovider-dl@snowflake.com 负责任地披露。

⚠️ 免责声明：本项目为 GA 版本，但某些功能仍在预览阶段。此类资源和数据源无论其在 Snowflake 中的状态如何，都被视为提供者中的预览功能。我们不保证它们的稳定性。它们将在未来的版本中被重构并标记为稳定功能。这些功能预计会有破坏性变更，即使在不提升主版本号的情况下也可能发生。默认情况下，它们是禁用的。要使用这些功能，请在 提供者配置 的 preview_features_enabled 字段中添加相关功能名称。以下是预览功能的列表。请始终参考我们 GitHub 仓库中的 获取帮助 部分，以最佳确定如何解答您的问题。

贡献：我们欢迎对此项目的任何贡献！在提交 PR 前，请务必熟悉 我们的贡献指南！

---

这是一个用于管理 Snowflake 资源的 Terraform 提供者。

目录

• Snowflake Terraform 提供者
  • 目录
  • 快速入门
  • 支持架构
  • 迁移指南
  • 路线图
  • 获取帮助
  • 您想创建一个问题吗？
  • 额外的 SQL 客户端配置
  • 贡献
  • 发行版

快速入门

当前提供者在 Terraform 注册表中的命名空间是 snowflakedb。

如果您仍在使用 chanzuckerberg/snowflake 源，请参见 从 CZI 提供者升级 以升级到 Snowflake-Labs 命名空间。

如果您仍在使用 Snowflake-Labs/snowflake 源，请参见 从 Snowflake-Labs 提供者升级 以升级到 snowflakedb 命名空间。

通过在 Terraform 代码库中添加一个需求块和一个提供者块来安装 Snowflake Terraform 提供者：

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
}

关于提供商配置的更多信息，请参阅 Terraform 注册中心中的提供商文档。

不要忘记运行 terraform init，然后您就可以开始了！🚀

开始浏览 注册中心文档，以查找要使用的资源和数据源。

支持的架构

我们整理了一份列表，以明确哪些二进制文件是官方支持的，哪些是额外提供但未官方支持的。 这些列表基于底层 gosnowflake 驱动 支持的内容以及 HashiCorp 对 Terraform 提供商的推荐。

Snowflake Terraform 提供商支持以下架构：

• Windows：amd64
• Linux：amd64 和 arm64
• Darwin：amd64 和 arm64

我们还提供了其他配置，但它们未官方支持，且我们不优先处理它们的修复：

• Windows：arm64 和 386
• Linux：386
• Darwin：386
• Freebsd：任何架构

迁移指南

在更改提供商版本时，请查看 迁移指南。

路线图

查看 路线图。

获取帮助

以下是一些可能对您有帮助的链接：

• 入门教程 演示了如何为 Terraform 设置您的 Snowflake 账户（服务用户、角色、认证等）以及如何在 Terraform 中创建您的第一个资源。
• Terraform 注册中心的文档 完整地介绍了所有支持和更高级的示例。
• 此代码库的 讨论区域，我们使用此论坛讨论新功能和提供商的更改。
• 如果您是企业客户，请联系您的账户团队。这有助于我们优先处理问题。
• 问题部分 可能已经有了针对您问题的条目。

您想要创建一个问题吗？

如果您想创建一个 GitHub 问题，请先阅读我们的 指南。 它包含有用的链接、常见问题和已知解决方案，这些可能已经解决了您的问题。

额外的 SQL 客户端配置

该提供商使用底层 gosnowflake 驱动发送 SQL 命令至 Snowflake。

默认情况下，底层驱动设置为错误级别日志。可以通过在配置中设置 driver_tracing 字段来更改日志级别（从最详细到最少详细）：

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

在 提供商配置文档 中了解更多。

贡献

查看 贡献指南。

发布版本

将根据需要执行发布，通常每两周一次。

发布版本将发布到 Terraform 注册中心。每个更改都有其自己的发布说明（例如 https://github.com/snowflakedb/terraform-provider-snowflake/releases/tag/v0.89.0）以及在需要时的迁移指南（例如 https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/MIGRATION_GUIDE.md#v0880--v0890）。