# snowflakedb/terraform-provider-snowflake architecture

> Architecture diagram of the GitHub repository snowflakedb/terraform-provider-snowflake, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/snowflakedb/terraform-provider-snowflake
- Repository: https://github.com/snowflakedb/terraform-provider-snowflake

## Overview

This is the Snowflake Terraform provider: Terraform configuration is planned and applied through the provider to manage Snowflake objects using SQL. The main workflow is configuration → provider resource or data-source handling → SDK request/query operations → Snowflake, with returned state or queried objects exposed to Terraform. The tree also shows storage-integration variants and lifecycle policies, including an attachment resource. The detailed source excerpts focus on these storage features; broader resource coverage is documented by the README, while most provider registration and other resource implementations were not sampled.

Main entry points: [`pkg/sdk/storage_integrations_gen.go`](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/sdk/storage_integrations_gen.go) (Storage operations), [`pkg/provider/provider.go`](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/provider/provider.go) (Object resources), [`pkg/sdk/storage_lifecycle_policies_gen.go`](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/sdk/storage_lifecycle_policies_gen.go) (Lifecycle operations), [`pkg/datasources/storage_integrations.go`](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/datasources/storage_integrations.go) (Storage queries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_provider["Terraform provider"]
  node_provider_entry["Provider entry<br/>[main.go]"]
  node_provider_setup["Provider configuration<br/>[provider.go]"]
  node_resource_catalog["Object resources<br/>[provider.go]"]
  node_datasource_catalog["Object data sources<br/>[provider.go]"]
  node_preview_features["Preview controls"]
end

subgraph group_storage["Storage management"]
  node_storage_resource["Storage integrations"]
  node_aws_integration["AWS integration"]
  node_azure_integration["Azure integration"]
  node_gcs_integration["GCS integration"]
  node_lifecycle_policy["Lifecycle policies"]
  node_policy_attachment["Policy attachment"]
  node_storage_datasource["Storage queries"]
  node_lifecycle_datasource["Lifecycle queries"]
end

subgraph group_sdk["Snowflake SDK"]
  node_sdk_storage["Storage operations"]
  node_sdk_lifecycle["Lifecycle operations"]
  node_query_definitions["SQL definitions"]
  node_storage_schemas["Storage schemas"]
end

node_terraform(("Terraform CLI"))
node_snowflake[("Snowflake account")]

node_terraform -->|"starts provider"| node_provider_entry
node_provider_entry -->|"loads configuration"| node_provider_setup
node_terraform -->|"plans and applies"| node_resource_catalog
node_terraform -.->|"queries objects"| node_datasource_catalog
node_resource_catalog -.->|"handles integration"| node_storage_resource
node_resource_catalog -.->|"handles policy"| node_lifecycle_policy
node_resource_catalog -.->|"handles attachment"| node_policy_attachment
node_datasource_catalog -.->|"exposes query"| node_storage_datasource
node_datasource_catalog -.->|"exposes query"| node_lifecycle_datasource
node_storage_resource -->|"builds requests"| node_sdk_storage
node_aws_integration -->|"builds requests"| node_sdk_storage
node_azure_integration -->|"builds requests"| node_sdk_storage
node_gcs_integration -.->|"uses SDK"| node_sdk_storage
node_lifecycle_policy -->|"uses SDK"| node_sdk_lifecycle
node_policy_attachment -->|"uses SDK"| node_sdk_lifecycle
node_storage_datasource -->|"shows objects"| node_sdk_storage
node_storage_datasource -->|"converts results"| node_storage_schemas
node_lifecycle_datasource -->|"shows objects"| node_sdk_lifecycle
node_sdk_storage -->|"executes SQL"| node_snowflake
node_sdk_lifecycle -.->|"executes SQL"| node_snowflake
node_query_definitions -.->|"defines operations"| node_sdk_storage
node_preview_features -.->|"gates features"| node_storage_resource

click node_provider_entry "https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/main.go"
click node_provider_setup "https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/provider/provider.go"
click node_resource_catalog "https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/provider/provider.go"
click node_datasource_catalog "https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/provider/provider.go"
click node_storage_resource "https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/resources/storage_integration.go"
click node_aws_integration "https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/resources/storage_integration_aws.go"
click node_azure_integration "https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/resources/storage_integration_azure.go"
click node_gcs_integration "https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/resources/storage_integration_gcs.go"
click node_lifecycle_policy "https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/resources/storage_lifecycle_policy.go"
click node_policy_attachment "https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/resources/table_storage_lifecycle_policy_attachment.go"
click node_storage_datasource "https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/datasources/storage_integrations.go"
click node_lifecycle_datasource "https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/datasources/storage_lifecycle_policies.go"
click node_sdk_storage "https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/sdk/storage_integrations_gen.go"
click node_sdk_lifecycle "https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/sdk/storage_lifecycle_policies_gen.go"
click node_query_definitions "https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/sdk/generator/defs/storage_integrations_def.go"
click node_storage_schemas "https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/schemas/storage_integration_all_details_gen.go"
click node_preview_features "https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/provider/previewfeatures/preview_features.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_provider_entry,node_provider_setup,node_resource_catalog,node_datasource_catalog,node_preview_features toneBlue
class node_storage_resource,node_aws_integration,node_azure_integration,node_gcs_integration,node_lifecycle_policy,node_policy_attachment,node_storage_datasource,node_lifecycle_datasource,node_snowflake toneAmber
class node_sdk_storage,node_sdk_lifecycle,node_query_definitions,node_storage_schemas toneMint
class node_terraform toneIndigo
```

## Components

### Terraform provider

- [Provider entry](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/main.go): `main.go`
- [Provider configuration](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/provider/provider.go): `pkg/provider/provider.go`
- [Object resources](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/provider/provider.go): `pkg/provider/provider.go`
- [Object data sources](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/provider/provider.go): `pkg/provider/provider.go`
- [Preview controls](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/provider/previewfeatures/preview_features.go): `pkg/provider/previewfeatures/preview_features.go`

### Storage management

- [Storage integrations](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/resources/storage_integration.go): `pkg/resources/storage_integration.go`
- [AWS integration](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/resources/storage_integration_aws.go): `pkg/resources/storage_integration_aws.go`
- [Azure integration](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/resources/storage_integration_azure.go): `pkg/resources/storage_integration_azure.go`
- [GCS integration](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/resources/storage_integration_gcs.go): `pkg/resources/storage_integration_gcs.go`
- [Lifecycle policies](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/resources/storage_lifecycle_policy.go): `pkg/resources/storage_lifecycle_policy.go`
- [Policy attachment](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/resources/table_storage_lifecycle_policy_attachment.go): `pkg/resources/table_storage_lifecycle_policy_attachment.go`
- [Storage queries](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/datasources/storage_integrations.go): `pkg/datasources/storage_integrations.go`
- [Lifecycle queries](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/datasources/storage_lifecycle_policies.go): `pkg/datasources/storage_lifecycle_policies.go`

### Snowflake SDK

- [Storage operations](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/sdk/storage_integrations_gen.go): `pkg/sdk/storage_integrations_gen.go`
- [Lifecycle operations](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/sdk/storage_lifecycle_policies_gen.go): `pkg/sdk/storage_lifecycle_policies_gen.go`
- [SQL definitions](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/sdk/generator/defs/storage_integrations_def.go): `pkg/sdk/generator/defs/storage_integrations_def.go`
- [Storage schemas](https://github.com/snowflakedb/terraform-provider-snowflake/blob/main/pkg/schemas/storage_integration_all_details_gen.go): `pkg/schemas/storage_integration_all_details_gen.go`

### Other components

- **Terraform CLI**
- **Snowflake account**

## Connections

- Terraform CLI → Provider entry: starts provider (evidence: `README.md`)
- Provider entry → Provider configuration: loads configuration (evidence: `main.go`)
- Terraform CLI → Object resources: plans and applies (evidence: `README.md`)
- Terraform CLI → Object data sources: queries objects (evidence: `README.md`)
- Object resources → Storage integrations: handles integration
- Object resources → Lifecycle policies: handles policy
- Object resources → Policy attachment: handles attachment
- Object data sources → Storage queries: exposes query
- Object data sources → Lifecycle queries: exposes query
- Storage integrations → Storage operations: builds requests (evidence: `pkg/resources/storage_integration.go`)
- AWS integration → Storage operations: builds requests (evidence: `pkg/resources/storage_integration_aws.go`)
- Azure integration → Storage operations: builds requests (evidence: `pkg/resources/storage_integration_azure.go`)
- GCS integration → Storage operations: uses SDK
- Lifecycle policies → Lifecycle operations: uses SDK (evidence: `pkg/resources/storage_lifecycle_policy.go`)
- Policy attachment → Lifecycle operations: uses SDK (evidence: `pkg/resources/table_storage_lifecycle_policy_attachment.go`)
- Storage queries → Storage operations: shows objects (evidence: `pkg/datasources/storage_integrations.go`)
- Storage queries → Storage schemas: converts results (evidence: `pkg/datasources/storage_integrations.go`)
- Lifecycle queries → Lifecycle operations: shows objects (evidence: `pkg/datasources/storage_lifecycle_policies.go`)
- Storage operations → Snowflake account: executes SQL (evidence: `README.md`)
- Lifecycle operations → Snowflake account: executes SQL
- SQL definitions → Storage operations: defines operations
- Preview controls → Storage integrations: gates features
