[Docs]: snowflake_tag_association: Unclear how to reference a tag by its literal name

[lostkamp]

Company Name

Flix

Object type(s)

resource:tag_association

Documentation Link

https://registry.terraform.io/providers/Snowflake-Labs/snowflake/latest/docs/resources/tag_association

Description

Hi,

I am trying to add a tag to a table like this:

resource "snowflake_tag_association" "table_tag" {
  object_identifier {
    name     = snowflake_table.id_assignment.name
    database = var.database
    schema   = var.schema
  }
  object_type = "TABLE"
  tag_id      = "\"MY_DB\".\"MY_SCHEMA\".\"some.tag\""
  tag_value   = "value"
}

However the apply step fails with Error: [errors.go:22] object does not exist or not authorized.

The docs only have examples of referencing tags by their terraform identifier. I am not sure if I overlooked something, but in any case I think it is worthwhile to add an example to the docs showing how to reference a tag that is not in terraform.

References

No response

Would you like to implement a fix?

• Yeah, I'll take it 😎

[sfc-gh-jmichalak]

Hi @lostkamp 👋

You seem to be using the old resource before rework. It has been reworked in v0.100.0 (release, migration guide). Please upgrade to at least this version.

1. The reference to your table should now look like object_identifiers = [snowflake_table.id_assignment.fully_qualified_name].
2. Under the example section, we link to our identifiers guide. There we explain how to reference objects managed outside Terraform.
3. If you still have some issues, please send logs with TF_LOG=DEBUG.

[lostkamp]

Hi Jakub,

thanks, you were right, the update solved the problem.

But I still think it makes sense to add such an example to the docs.

[sfc-gh-jmichalak]

Closing, because the fix is confirmed.

We link to this identifiers guide in the examples of all the resources. Using fully_qualified_name is the preferred way because it's less error-prone, and that's why it's present in the examples. We understand that some objects are not managed in Terraform and should be referenced "manually," and that's why this guide exists.