pulumi-snowflake 0.58.0__py3-none-any.whl → 0.58.0a1722528062__py3-none-any.whl

pulumi_snowflake/tag_association.py

@@ -230,7 +230,7 @@ class TagAssociation(pulumi.CustomResource):
     def __init__(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
-                 object_identifiers: Optional[pulumi.Input[Sequence[pulumi.Input[Union['TagAssociationObjectIdentifierArgs', 'TagAssociationObjectIdentifierArgsDict']]]]] = None,
+                 object_identifiers: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['TagAssociationObjectIdentifierArgs']]]]] = None,
                  object_name: Optional[pulumi.Input[str]] = None,
                  object_type: Optional[pulumi.Input[str]] = None,
                  skip_validation: Optional[pulumi.Input[bool]] = None,
@@ -238,6 +238,66 @@ class TagAssociation(pulumi.CustomResource):
                  tag_value: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_snowflake as snowflake
+
+        test = snowflake.Database("test", name="database")
+        test_schema = snowflake.Schema("test",
+            name="schema",
+            database=test.name)
+        test_tag = snowflake.Tag("test",
+            name="cost_center",
+            database=test.name,
+            schema=test_schema.name,
+            allowed_values=[
+                "finance",
+                "engineering",
+            ])
+        db_association = snowflake.TagAssociation("db_association",
+            object_identifiers=[snowflake.TagAssociationObjectIdentifierArgs(
+                name=test.name,
+            )],
+            object_type="DATABASE",
+            tag_id=test_tag.id,
+            tag_value="finance")
+        test_table = snowflake.Table("test",
+            database=test.name,
+            schema=test_schema.name,
+            name="TABLE_NAME",
+            comment="Terraform example table",
+            columns=[
+                snowflake.TableColumnArgs(
+                    name="column1",
+                    type="VARIANT",
+                ),
+                snowflake.TableColumnArgs(
+                    name="column2",
+                    type="VARCHAR(16)",
+                ),
+            ])
+        table_association = snowflake.TagAssociation("table_association",
+            object_identifiers=[snowflake.TagAssociationObjectIdentifierArgs(
+                name=test_table.name,
+                database=test.name,
+                schema=test_schema.name,
+            )],
+            object_type="TABLE",
+            tag_id=test_tag.id,
+            tag_value="engineering")
+        column_association = snowflake.TagAssociation("column_association",
+            object_identifiers=[snowflake.TagAssociationObjectIdentifierArgs(
+                name=test_table.name.apply(lambda name: f"{name}.column_name"),
+                database=test.name,
+                schema=test_schema.name,
+            )],
+            object_type="COLUMN",
+            tag_id=test_tag.id,
+            tag_value="engineering")
+        ```
+
         ## Import
 
         format is dbName.schemaName.tagName or dbName.schemaName.tagName
@@ -248,7 +308,7 @@ class TagAssociation(pulumi.CustomResource):
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[Sequence[pulumi.Input[Union['TagAssociationObjectIdentifierArgs', 'TagAssociationObjectIdentifierArgsDict']]]] object_identifiers: Specifies the object identifier for the tag association.
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['TagAssociationObjectIdentifierArgs']]]] object_identifiers: Specifies the object identifier for the tag association.
         :param pulumi.Input[str] object_name: Specifies the object identifier for the tag association.
         :param pulumi.Input[str] object_type: Specifies the type of object to add a tag. Allowed object types: [ACCOUNT APPLICATION APPLICATION PACKAGE DATABASE INTEGRATION NETWORK POLICY ROLE SHARE USER WAREHOUSE DATABASE ROLE SCHEMA ALERT EXTERNAL FUNCTION EXTERNAL TABLE GIT REPOSITORY ICEBERG TABLE MATERIALIZED VIEW PIPE MASKING POLICY PASSWORD POLICY ROW ACCESS POLICY SESSION POLICY PROCEDURE STAGE STREAM TABLE TASK VIEW COLUMN EVENT TABLE].
         :param pulumi.Input[bool] skip_validation: If true, skips validation of the tag association.
@@ -262,6 +322,66 @@ class TagAssociation(pulumi.CustomResource):
                  args: TagAssociationArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_snowflake as snowflake
+
+        test = snowflake.Database("test", name="database")
+        test_schema = snowflake.Schema("test",
+            name="schema",
+            database=test.name)
+        test_tag = snowflake.Tag("test",
+            name="cost_center",
+            database=test.name,
+            schema=test_schema.name,
+            allowed_values=[
+                "finance",
+                "engineering",
+            ])
+        db_association = snowflake.TagAssociation("db_association",
+            object_identifiers=[snowflake.TagAssociationObjectIdentifierArgs(
+                name=test.name,
+            )],
+            object_type="DATABASE",
+            tag_id=test_tag.id,
+            tag_value="finance")
+        test_table = snowflake.Table("test",
+            database=test.name,
+            schema=test_schema.name,
+            name="TABLE_NAME",
+            comment="Terraform example table",
+            columns=[
+                snowflake.TableColumnArgs(
+                    name="column1",
+                    type="VARIANT",
+                ),
+                snowflake.TableColumnArgs(
+                    name="column2",
+                    type="VARCHAR(16)",
+                ),
+            ])
+        table_association = snowflake.TagAssociation("table_association",
+            object_identifiers=[snowflake.TagAssociationObjectIdentifierArgs(
+                name=test_table.name,
+                database=test.name,
+                schema=test_schema.name,
+            )],
+            object_type="TABLE",
+            tag_id=test_tag.id,
+            tag_value="engineering")
+        column_association = snowflake.TagAssociation("column_association",
+            object_identifiers=[snowflake.TagAssociationObjectIdentifierArgs(
+                name=test_table.name.apply(lambda name: f"{name}.column_name"),
+                database=test.name,
+                schema=test_schema.name,
+            )],
+            object_type="COLUMN",
+            tag_id=test_tag.id,
+            tag_value="engineering")
+        ```
+
         ## Import
 
         format is dbName.schemaName.tagName or dbName.schemaName.tagName
@@ -285,7 +405,7 @@ class TagAssociation(pulumi.CustomResource):
     def _internal_init(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
-                 object_identifiers: Optional[pulumi.Input[Sequence[pulumi.Input[Union['TagAssociationObjectIdentifierArgs', 'TagAssociationObjectIdentifierArgsDict']]]]] = None,
+                 object_identifiers: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['TagAssociationObjectIdentifierArgs']]]]] = None,
                  object_name: Optional[pulumi.Input[str]] = None,
                  object_type: Optional[pulumi.Input[str]] = None,
                  skip_validation: Optional[pulumi.Input[bool]] = None,
@@ -324,7 +444,7 @@ class TagAssociation(pulumi.CustomResource):
     def get(resource_name: str,
             id: pulumi.Input[str],
             opts: Optional[pulumi.ResourceOptions] = None,
-            object_identifiers: Optional[pulumi.Input[Sequence[pulumi.Input[Union['TagAssociationObjectIdentifierArgs', 'TagAssociationObjectIdentifierArgsDict']]]]] = None,
+            object_identifiers: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['TagAssociationObjectIdentifierArgs']]]]] = None,
             object_name: Optional[pulumi.Input[str]] = None,
             object_type: Optional[pulumi.Input[str]] = None,
             skip_validation: Optional[pulumi.Input[bool]] = None,
@@ -337,7 +457,7 @@ class TagAssociation(pulumi.CustomResource):
         :param str resource_name: The unique name of the resulting resource.
         :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[Sequence[pulumi.Input[Union['TagAssociationObjectIdentifierArgs', 'TagAssociationObjectIdentifierArgsDict']]]] object_identifiers: Specifies the object identifier for the tag association.
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['TagAssociationObjectIdentifierArgs']]]] object_identifiers: Specifies the object identifier for the tag association.
         :param pulumi.Input[str] object_name: Specifies the object identifier for the tag association.
         :param pulumi.Input[str] object_type: Specifies the type of object to add a tag. Allowed object types: [ACCOUNT APPLICATION APPLICATION PACKAGE DATABASE INTEGRATION NETWORK POLICY ROLE SHARE USER WAREHOUSE DATABASE ROLE SCHEMA ALERT EXTERNAL FUNCTION EXTERNAL TABLE GIT REPOSITORY ICEBERG TABLE MATERIALIZED VIEW PIPE MASKING POLICY PASSWORD POLICY ROW ACCESS POLICY SESSION POLICY PROCEDURE STAGE STREAM TABLE TASK VIEW COLUMN EVENT TABLE].
         :param pulumi.Input[bool] skip_validation: If true, skips validation of the tag association.

pulumi_snowflake/tag_masking_policy_association.py

@@ -98,6 +98,8 @@ class TagMaskingPolicyAssociation(pulumi.CustomResource):
                  tag_id: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
+        Attach a masking policy to a tag. Requires a current warehouse to be set. Either with SNOWFLAKE_WAREHOUSE env variable or in current session. If no warehouse is provided, a temporary warehouse will be created.
+
         ## Import
 
         format is tag database name | tag schema name | tag name | masking policy database | masking policy schema | masking policy name
@@ -118,6 +120,8 @@ class TagMaskingPolicyAssociation(pulumi.CustomResource):
                  args: TagMaskingPolicyAssociationArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
+        Attach a masking policy to a tag. Requires a current warehouse to be set. Either with SNOWFLAKE_WAREHOUSE env variable or in current session. If no warehouse is provided, a temporary warehouse will be created.
+
         ## Import
 
         format is tag database name | tag schema name | tag name | masking policy database | masking policy schema | masking policy name

pulumi_snowflake/task.py

@@ -281,7 +281,6 @@ class _TaskState:
                  database: Optional[pulumi.Input[str]] = None,
                  enabled: Optional[pulumi.Input[bool]] = None,
                  error_integration: Optional[pulumi.Input[str]] = None,
-                 fully_qualified_name: Optional[pulumi.Input[str]] = None,
                  name: Optional[pulumi.Input[str]] = None,
                  schedule: Optional[pulumi.Input[str]] = None,
                  schema: Optional[pulumi.Input[str]] = None,
@@ -300,7 +299,6 @@ class _TaskState:
         :param pulumi.Input[str] database: The database in which to create the task.
         :param pulumi.Input[bool] enabled: Specifies if the task should be started (enabled) after creation or should remain suspended (default).
         :param pulumi.Input[str] error_integration: Specifies the name of the notification integration used for error notifications.
-        :param pulumi.Input[str] fully_qualified_name: Fully qualified name of the resource. For more information, see [object name resolution](https://docs.snowflake.com/en/sql-reference/name-resolution).
         :param pulumi.Input[str] name: Specifies the identifier for the task; must be unique for the database and schema in which the task is created.
         :param pulumi.Input[str] schedule: The schedule for periodically running the task. This can be a cron or interval in minutes. (Conflict with after)
         :param pulumi.Input[str] schema: The schema in which to create the task.
@@ -324,8 +322,6 @@ class _TaskState:
             pulumi.set(__self__, "enabled", enabled)
         if error_integration is not None:
             pulumi.set(__self__, "error_integration", error_integration)
-        if fully_qualified_name is not None:
-            pulumi.set(__self__, "fully_qualified_name", fully_qualified_name)
         if name is not None:
             pulumi.set(__self__, "name", name)
         if schedule is not None:
@@ -419,18 +415,6 @@ class _TaskState:
     def error_integration(self, value: Optional[pulumi.Input[str]]):
         pulumi.set(self, "error_integration", value)
 
-    @property
-    @pulumi.getter(name="fullyQualifiedName")
-    def fully_qualified_name(self) -> Optional[pulumi.Input[str]]:
-        """
-        Fully qualified name of the resource. For more information, see [object name resolution](https://docs.snowflake.com/en/sql-reference/name-resolution).
-        """
-        return pulumi.get(self, "fully_qualified_name")
-
-    @fully_qualified_name.setter
-    def fully_qualified_name(self, value: Optional[pulumi.Input[str]]):
-        pulumi.set(self, "fully_qualified_name", value)
-
     @property
     @pulumi.getter
     def name(self) -> Optional[pulumi.Input[str]]:
@@ -575,6 +559,52 @@ class Task(pulumi.CustomResource):
                  when: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_snowflake as snowflake
+
+        task = snowflake.Task("task",
+            comment="my task",
+            database="database",
+            schema="schema",
+            warehouse="warehouse",
+            name="task",
+            schedule="10 MINUTE",
+            sql_statement="select * from foo;",
+            session_parameters={
+                "foo": "bar",
+            },
+            user_task_timeout_ms=10000,
+            afters="preceding_task",
+            when="foo AND bar",
+            enabled=True)
+        serverless_task = snowflake.Task("serverless_task",
+            comment="my serverless task",
+            database="db",
+            schema="schema",
+            name="serverless_task",
+            schedule="10 MINUTE",
+            sql_statement="select * from foo;",
+            session_parameters={
+                "foo": "bar",
+            },
+            user_task_timeout_ms=10000,
+            user_task_managed_initial_warehouse_size="XSMALL",
+            afters=[task.name],
+            when="foo AND bar",
+            enabled=True)
+        test_task = snowflake.Task("test_task",
+            comment="task with allow_overlapping_execution",
+            database="database",
+            schema="schema",
+            name="test_task",
+            sql_statement="select 1 as c;",
+            allow_overlapping_execution=True,
+            enabled=True)
+        ```
+
         ## Import
 
         format is database name | schema name | task name
@@ -609,6 +639,52 @@ class Task(pulumi.CustomResource):
                  args: TaskArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_snowflake as snowflake
+
+        task = snowflake.Task("task",
+            comment="my task",
+            database="database",
+            schema="schema",
+            warehouse="warehouse",
+            name="task",
+            schedule="10 MINUTE",
+            sql_statement="select * from foo;",
+            session_parameters={
+                "foo": "bar",
+            },
+            user_task_timeout_ms=10000,
+            afters="preceding_task",
+            when="foo AND bar",
+            enabled=True)
+        serverless_task = snowflake.Task("serverless_task",
+            comment="my serverless task",
+            database="db",
+            schema="schema",
+            name="serverless_task",
+            schedule="10 MINUTE",
+            sql_statement="select * from foo;",
+            session_parameters={
+                "foo": "bar",
+            },
+            user_task_timeout_ms=10000,
+            user_task_managed_initial_warehouse_size="XSMALL",
+            afters=[task.name],
+            when="foo AND bar",
+            enabled=True)
+        test_task = snowflake.Task("test_task",
+            comment="task with allow_overlapping_execution",
+            database="database",
+            schema="schema",
+            name="test_task",
+            sql_statement="select 1 as c;",
+            allow_overlapping_execution=True,
+            enabled=True)
+        ```
+
         ## Import
 
         format is database name | schema name | task name
@@ -679,7 +755,6 @@ class Task(pulumi.CustomResource):
             __props__.__dict__["user_task_timeout_ms"] = user_task_timeout_ms
             __props__.__dict__["warehouse"] = warehouse
             __props__.__dict__["when"] = when
-            __props__.__dict__["fully_qualified_name"] = None
         super(Task, __self__).__init__(
             'snowflake:index/task:Task',
             resource_name,
@@ -696,7 +771,6 @@ class Task(pulumi.CustomResource):
             database: Optional[pulumi.Input[str]] = None,
             enabled: Optional[pulumi.Input[bool]] = None,
             error_integration: Optional[pulumi.Input[str]] = None,
-            fully_qualified_name: Optional[pulumi.Input[str]] = None,
             name: Optional[pulumi.Input[str]] = None,
             schedule: Optional[pulumi.Input[str]] = None,
             schema: Optional[pulumi.Input[str]] = None,
@@ -720,7 +794,6 @@ class Task(pulumi.CustomResource):
         :param pulumi.Input[str] database: The database in which to create the task.
         :param pulumi.Input[bool] enabled: Specifies if the task should be started (enabled) after creation or should remain suspended (default).
         :param pulumi.Input[str] error_integration: Specifies the name of the notification integration used for error notifications.
-        :param pulumi.Input[str] fully_qualified_name: Fully qualified name of the resource. For more information, see [object name resolution](https://docs.snowflake.com/en/sql-reference/name-resolution).
         :param pulumi.Input[str] name: Specifies the identifier for the task; must be unique for the database and schema in which the task is created.
         :param pulumi.Input[str] schedule: The schedule for periodically running the task. This can be a cron or interval in minutes. (Conflict with after)
         :param pulumi.Input[str] schema: The schema in which to create the task.
@@ -742,7 +815,6 @@ class Task(pulumi.CustomResource):
         __props__.__dict__["database"] = database
         __props__.__dict__["enabled"] = enabled
         __props__.__dict__["error_integration"] = error_integration
-        __props__.__dict__["fully_qualified_name"] = fully_qualified_name
         __props__.__dict__["name"] = name
         __props__.__dict__["schedule"] = schedule
         __props__.__dict__["schema"] = schema
@@ -803,14 +875,6 @@ class Task(pulumi.CustomResource):
         """
         return pulumi.get(self, "error_integration")
 
-    @property
-    @pulumi.getter(name="fullyQualifiedName")
-    def fully_qualified_name(self) -> pulumi.Output[str]:
-        """
-        Fully qualified name of the resource. For more information, see [object name resolution](https://docs.snowflake.com/en/sql-reference/name-resolution).
-        """
-        return pulumi.get(self, "fully_qualified_name")
-
     @property
     @pulumi.getter
     def name(self) -> pulumi.Output[str]:

pulumi_snowflake/unsafe_execute.py

@@ -147,7 +147,16 @@ class UnsafeExecute(pulumi.CustomResource):
                  revert: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        Create a UnsafeExecute resource with the given unique name, props, and options.
+        !> **Warning** This is a dangerous resource that allows executing **ANY** SQL statement. It may destroy resources if used incorrectly. It may behave incorrectly combined with other resources. Use at your own risk.
+
+        > **Note** This resource will be included in the V1 (check here.
+
+        > **Note** It can be theoretically used to manage resource that are not supported by the provider. This is risky and may brake other resources if used incorrectly.
+
+        > **Note** Use `query` parameter with caution. It will fetch **ALL** the results returned by the query provided. Try to limit the number of results by writing query with filters. Query failure does not stop resource creation; it simply results in `query_results` being empty.
+
+        Experimental resource allowing execution of ANY SQL statement. It may destroy resources if used incorrectly. It may behave incorrectly combined with other resources. Use at your own risk.
+
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[str] execute: SQL statement to execute. Forces recreation of resource on change.
@@ -161,7 +170,16 @@ class UnsafeExecute(pulumi.CustomResource):
                  args: UnsafeExecuteArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Create a UnsafeExecute resource with the given unique name, props, and options.
+        !> **Warning** This is a dangerous resource that allows executing **ANY** SQL statement. It may destroy resources if used incorrectly. It may behave incorrectly combined with other resources. Use at your own risk.
+
+        > **Note** This resource will be included in the V1 (check here.
+
+        > **Note** It can be theoretically used to manage resource that are not supported by the provider. This is risky and may brake other resources if used incorrectly.
+
+        > **Note** Use `query` parameter with caution. It will fetch **ALL** the results returned by the query provided. Try to limit the number of results by writing query with filters. Query failure does not stop resource creation; it simply results in `query_results` being empty.
+
+        Experimental resource allowing execution of ANY SQL statement. It may destroy resources if used incorrectly. It may behave incorrectly combined with other resources. Use at your own risk.
+
         :param str resource_name: The name of the resource.
         :param UnsafeExecuteArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.