From c17d7794d4ac21d54fd1db33ec2eb325fd699c39 Mon Sep 17 00:00:00 2001
From: David Szmolka <69192509+sfc-gh-dszmolka@users.noreply.github.com>
Date: Thu, 26 Dec 2024 09:48:55 +0100
Subject: [PATCH] add examples for stage's file_format from #265

---
 docs/resources/stage.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/resources/stage.md b/docs/resources/stage.md
index 6e8cf7841e..25a149cbb2 100644
--- a/docs/resources/stage.md
+++ b/docs/resources/stage.md
@@ -44,6 +44,12 @@ resource "snowflake_stage" "example_stage" {
 - `directory` (String) Specifies the directory settings for the stage.
 - `encryption` (String) Specifies the encryption settings for the stage.
 - `file_format` (String) Specifies the file format for the stage. Specifying the default Snowflake value (e.g. TYPE = CSV) will currently result in a permadiff (check [#2679](https://github.com/Snowflake-Labs/terraform-provider-snowflake/issues/2679)). For now, omit the default values; it will be fixed in the upcoming provider versions.
+
+  Examples of usage:
+  * with hardcoding value: `file_format="FORMAT_NAME = DB.SCHEMA.FORMATNAME"`
+  * from dynamic value: `file_format = "FORMAT_NAME = ${snowflake_database.mydb.name}.${snowflake_schema.myschema.name}.${snowflake_file_format.myfileformat.name}"`
+  * from expression: `file_format = format("FORMAT_NAME =%s.%s.MYFILEFORMAT", var.db_name, each.value.schema_name)`
+(Reference: [#265](https://github.com/Snowflake-Labs/terraform-provider-snowflake/issues/265))
 - `snowflake_iam_user` (String) An AWS IAM user created for your Snowflake account. This user is the same for every external S3 stage created in your account.
 - `storage_integration` (String) Specifies the name of the storage integration used to delegate authentication responsibility for external cloud storage to a Snowflake identity and access management (IAM) entity.
 - `tag` (Block List, Deprecated) Definitions of a tag to associate with the resource. (see [below for nested schema](#nestedblock--tag))