pulumi-snowflake 0.50.2a1709892015__py3-none-any.whl → 1.2.0a1736835738__py3-none-any.whl

pulumi_snowflake/{unsafe_execute.py → execute.py}

@@ -4,24 +4,29 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 
-__all__ = ['UnsafeExecuteArgs', 'UnsafeExecute']
+__all__ = ['ExecuteArgs', 'Execute']
 
 @pulumi.input_type
-class UnsafeExecuteArgs:
+class ExecuteArgs:
     def __init__(__self__, *,
                  execute: pulumi.Input[str],
                  revert: pulumi.Input[str],
                  query: Optional[pulumi.Input[str]] = None):
         """
-        The set of arguments for constructing a UnsafeExecute resource.
+        The set of arguments for constructing a Execute resource.
         :param pulumi.Input[str] execute: SQL statement to execute. Forces recreation of resource on change.
         :param pulumi.Input[str] revert: SQL statement to revert the execute statement. Invoked when resource is being destroyed.
-        :param pulumi.Input[str] query: Optional SQL statement to do a read. Invoked after creation and every time it is changed.
+        :param pulumi.Input[str] query: Optional SQL statement to do a read. Invoked on every resource refresh and every time it is changed.
         """
         pulumi.set(__self__, "execute", execute)
         pulumi.set(__self__, "revert", revert)
@@ -56,7 +61,7 @@ class UnsafeExecuteArgs:
     @pulumi.getter
     def query(self) -> Optional[pulumi.Input[str]]:
         """
-        Optional SQL statement to do a read. Invoked after creation and every time it is changed.
+        Optional SQL statement to do a read. Invoked on every resource refresh and every time it is changed.
         """
         return pulumi.get(self, "query")
 
@@ -66,16 +71,16 @@ class UnsafeExecuteArgs:
 
 
 @pulumi.input_type
-class _UnsafeExecuteState:
+class _ExecuteState:
     def __init__(__self__, *,
                  execute: Optional[pulumi.Input[str]] = None,
                  query: Optional[pulumi.Input[str]] = None,
                  query_results: Optional[pulumi.Input[Sequence[pulumi.Input[Mapping[str, pulumi.Input[str]]]]]] = None,
                  revert: Optional[pulumi.Input[str]] = None):
         """
-        Input properties used for looking up and filtering UnsafeExecute resources.
+        Input properties used for looking up and filtering Execute resources.
         :param pulumi.Input[str] execute: SQL statement to execute. Forces recreation of resource on change.
-        :param pulumi.Input[str] query: Optional SQL statement to do a read. Invoked after creation and every time it is changed.
+        :param pulumi.Input[str] query: Optional SQL statement to do a read. Invoked on every resource refresh and every time it is changed.
         :param pulumi.Input[Sequence[pulumi.Input[Mapping[str, pulumi.Input[str]]]]] query_results: List of key-value maps (text to text) retrieved after executing read query. Will be empty if the query results in an error.
         :param pulumi.Input[str] revert: SQL statement to revert the execute statement. Invoked when resource is being destroyed.
         """
@@ -104,7 +109,7 @@ class _UnsafeExecuteState:
     @pulumi.getter
     def query(self) -> Optional[pulumi.Input[str]]:
         """
-        Optional SQL statement to do a read. Invoked after creation and every time it is changed.
+        Optional SQL statement to do a read. Invoked on every resource refresh and every time it is changed.
         """
         return pulumi.get(self, "query")
 
@@ -137,7 +142,7 @@ class _UnsafeExecuteState:
         pulumi.set(self, "revert", value)
 
 
-class UnsafeExecute(pulumi.CustomResource):
+class Execute(pulumi.CustomResource):
     @overload
     def __init__(__self__,
                  resource_name: str,
@@ -147,146 +152,38 @@ class UnsafeExecute(pulumi.CustomResource):
                  revert: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        !> **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. Will be deleted in the upcoming versions. Use at your own risk.
+        ## Import
 
-        > **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.
-
-        > **Deprecation** Experimental resource. Will be deleted in the upcoming versions. Use at your own risk. <deprecation>
-
-        Experimental resource used for testing purposes only. Allows to execute ANY SQL statement.
-
-        ## Example Usage
-        ### simple use cases
-        ##################################
-
-        # create and destroy resource
-        resource "snowflake_unsafe_execute" "test" {
-          execute = "CREATE DATABASE ABC"
-          revert  = "DROP DATABASE ABC"
-        }
-
-        # create and destroy resource using qualified name
-        resource "snowflake_unsafe_execute" "test" {
-          execute = "CREATE DATABASE \\"abc\\""
-          revert  = "DROP DATABASE \\"abc\\""
-        }
-
-        # with query
-        resource "snowflake_unsafe_execute" "test" {
-          execute = "CREATE DATABASE ABC"
-          revert  = "DROP DATABASE ABC"
-          query   = "SHOW DATABASES LIKE '%ABC%'"
-        }
-
-        ##################################
-        ### grants example
-        ##################################
-
-        # grant and revoke privilege USAGE to ROLE on database
-        resource "snowflake_unsafe_execute" "test" {
-          execute = "GRANT USAGE ON DATABASE ABC TO ROLE XYZ"
-          revert  = "REVOKE USAGE ON DATABASE ABC FROM ROLE XYZ"
-        }
-
-        # grant and revoke with for_each
-        variable "database_grants" {
-          type = list(object({
-            database_name = string
-            role_id       = string
-            privileges    = list(string)
-          }))
-        }
-
-        resource "snowflake_unsafe_execute" "test" {
-          for_each = { for index, db_grant in var.database_grants : index => db_grant }
-          execute  = "GRANT ${join(",", each.value.privileges)} ON DATABASE ${each.value.database_name} TO ROLE ${each.value.role_id}"
-          revert   = "REVOKE ${join(",", each.value.privileges)} ON DATABASE ${each.value.database_name} FROM ROLE ${each.value.role_id}"
-        }
-
-        ##################################
+        ```sh
+        $ pulumi import snowflake:index/execute:Execute example '<random_uuid>'
+        ```
 
         :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.
-        :param pulumi.Input[str] query: Optional SQL statement to do a read. Invoked after creation and every time it is changed.
+        :param pulumi.Input[str] query: Optional SQL statement to do a read. Invoked on every resource refresh and every time it is changed.
         :param pulumi.Input[str] revert: SQL statement to revert the execute statement. Invoked when resource is being destroyed.
         """
         ...
     @overload
     def __init__(__self__,
                  resource_name: str,
-                 args: UnsafeExecuteArgs,
+                 args: ExecuteArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        !> **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. Will be deleted in the upcoming versions. Use at your own risk.
-
-        > **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.
-
-        > **Deprecation** Experimental resource. Will be deleted in the upcoming versions. Use at your own risk. <deprecation>
-
-        Experimental resource used for testing purposes only. Allows to execute ANY SQL statement.
-
-        ## Example Usage
-        ### simple use cases
-        ##################################
-
-        # create and destroy resource
-        resource "snowflake_unsafe_execute" "test" {
-          execute = "CREATE DATABASE ABC"
-          revert  = "DROP DATABASE ABC"
-        }
-
-        # create and destroy resource using qualified name
-        resource "snowflake_unsafe_execute" "test" {
-          execute = "CREATE DATABASE \\"abc\\""
-          revert  = "DROP DATABASE \\"abc\\""
-        }
-
-        # with query
-        resource "snowflake_unsafe_execute" "test" {
-          execute = "CREATE DATABASE ABC"
-          revert  = "DROP DATABASE ABC"
-          query   = "SHOW DATABASES LIKE '%ABC%'"
-        }
-
-        ##################################
-        ### grants example
-        ##################################
-
-        # grant and revoke privilege USAGE to ROLE on database
-        resource "snowflake_unsafe_execute" "test" {
-          execute = "GRANT USAGE ON DATABASE ABC TO ROLE XYZ"
-          revert  = "REVOKE USAGE ON DATABASE ABC FROM ROLE XYZ"
-        }
-
-        # grant and revoke with for_each
-        variable "database_grants" {
-          type = list(object({
-            database_name = string
-            role_id       = string
-            privileges    = list(string)
-          }))
-        }
-
-        resource "snowflake_unsafe_execute" "test" {
-          for_each = { for index, db_grant in var.database_grants : index => db_grant }
-          execute  = "GRANT ${join(",", each.value.privileges)} ON DATABASE ${each.value.database_name} TO ROLE ${each.value.role_id}"
-          revert   = "REVOKE ${join(",", each.value.privileges)} ON DATABASE ${each.value.database_name} FROM ROLE ${each.value.role_id}"
-        }
+        ## Import
 
-        ##################################
+        ```sh
+        $ pulumi import snowflake:index/execute:Execute example '<random_uuid>'
+        ```
 
         :param str resource_name: The name of the resource.
-        :param UnsafeExecuteArgs args: The arguments to use to populate this resource's properties.
+        :param ExecuteArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.
         """
         ...
     def __init__(__self__, resource_name: str, *args, **kwargs):
-        resource_args, opts = _utilities.get_resource_args_opts(UnsafeExecuteArgs, pulumi.ResourceOptions, *args, **kwargs)
+        resource_args, opts = _utilities.get_resource_args_opts(ExecuteArgs, pulumi.ResourceOptions, *args, **kwargs)
         if resource_args is not None:
             __self__._internal_init(resource_name, opts, **resource_args.__dict__)
         else:
@@ -305,7 +202,7 @@ class UnsafeExecute(pulumi.CustomResource):
         if opts.id is None:
             if __props__ is not None:
                 raise TypeError('__props__ is only valid when passed in combination with a valid opts.id to get an existing resource')
-            __props__ = UnsafeExecuteArgs.__new__(UnsafeExecuteArgs)
+            __props__ = ExecuteArgs.__new__(ExecuteArgs)
 
             if execute is None and not opts.urn:
                 raise TypeError("Missing required property 'execute'")
@@ -315,8 +212,8 @@ class UnsafeExecute(pulumi.CustomResource):
                 raise TypeError("Missing required property 'revert'")
             __props__.__dict__["revert"] = revert
             __props__.__dict__["query_results"] = None
-        super(UnsafeExecute, __self__).__init__(
-            'snowflake:index/unsafeExecute:UnsafeExecute',
+        super(Execute, __self__).__init__(
+            'snowflake:index/execute:Execute',
             resource_name,
             __props__,
             opts)
@@ -328,28 +225,28 @@ class UnsafeExecute(pulumi.CustomResource):
             execute: Optional[pulumi.Input[str]] = None,
             query: Optional[pulumi.Input[str]] = None,
             query_results: Optional[pulumi.Input[Sequence[pulumi.Input[Mapping[str, pulumi.Input[str]]]]]] = None,
-            revert: Optional[pulumi.Input[str]] = None) -> 'UnsafeExecute':
+            revert: Optional[pulumi.Input[str]] = None) -> 'Execute':
         """
-        Get an existing UnsafeExecute resource's state with the given name, id, and optional extra
+        Get an existing Execute resource's state with the given name, id, and optional extra
         properties used to qualify the lookup.
 
         :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[str] execute: SQL statement to execute. Forces recreation of resource on change.
-        :param pulumi.Input[str] query: Optional SQL statement to do a read. Invoked after creation and every time it is changed.
+        :param pulumi.Input[str] query: Optional SQL statement to do a read. Invoked on every resource refresh and every time it is changed.
         :param pulumi.Input[Sequence[pulumi.Input[Mapping[str, pulumi.Input[str]]]]] query_results: List of key-value maps (text to text) retrieved after executing read query. Will be empty if the query results in an error.
         :param pulumi.Input[str] revert: SQL statement to revert the execute statement. Invoked when resource is being destroyed.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
-        __props__ = _UnsafeExecuteState.__new__(_UnsafeExecuteState)
+        __props__ = _ExecuteState.__new__(_ExecuteState)
 
         __props__.__dict__["execute"] = execute
         __props__.__dict__["query"] = query
         __props__.__dict__["query_results"] = query_results
         __props__.__dict__["revert"] = revert
-        return UnsafeExecute(resource_name, opts=opts, __props__=__props__)
+        return Execute(resource_name, opts=opts, __props__=__props__)
 
     @property
     @pulumi.getter
@@ -363,7 +260,7 @@ class UnsafeExecute(pulumi.CustomResource):
     @pulumi.getter
     def query(self) -> pulumi.Output[Optional[str]]:
         """
-        Optional SQL statement to do a read. Invoked after creation and every time it is changed.
+        Optional SQL statement to do a read. Invoked on every resource refresh and every time it is changed.
         """
         return pulumi.get(self, "query")
 

pulumi_snowflake/external_function.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 from . import outputs
 from ._inputs import *
@@ -47,7 +52,7 @@ class ExternalFunctionArgs:
         :param pulumi.Input[Sequence[pulumi.Input[str]]] context_headers: Binds Snowflake context function results to HTTP headers.
         :param pulumi.Input[Sequence[pulumi.Input['ExternalFunctionHeaderArgs']]] headers: Allows users to specify key-value metadata that is sent with every request as HTTP headers.
         :param pulumi.Input[int] max_batch_rows: This specifies the maximum number of rows in each batch sent to the proxy service.
-        :param pulumi.Input[str] name: Argument name
+        :param pulumi.Input[str] name: Specifies the identifier for the external function. The identifier can contain the schema name and database name, as well as the function name. The function's signature (name and argument data types) must be unique within the schema.
         :param pulumi.Input[str] null_input_behavior: Specifies the behavior of the external function when called with null inputs.
         :param pulumi.Input[str] request_translator: This specifies the name of the request translator function
         :param pulumi.Input[str] response_translator: This specifies the name of the response translator function.
@@ -230,7 +235,7 @@ class ExternalFunctionArgs:
     @pulumi.getter
     def name(self) -> Optional[pulumi.Input[str]]:
         """
-        Argument name
+        Specifies the identifier for the external function. The identifier can contain the schema name and database name, as well as the function name. The function's signature (name and argument data types) must be unique within the schema.
         """
         return pulumi.get(self, "name")
 
@@ -297,6 +302,7 @@ class _ExternalFunctionState:
                  context_headers: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                  created_on: Optional[pulumi.Input[str]] = None,
                  database: Optional[pulumi.Input[str]] = None,
+                 fully_qualified_name: Optional[pulumi.Input[str]] = None,
                  headers: Optional[pulumi.Input[Sequence[pulumi.Input['ExternalFunctionHeaderArgs']]]] = None,
                  max_batch_rows: Optional[pulumi.Input[int]] = None,
                  name: Optional[pulumi.Input[str]] = None,
@@ -317,9 +323,10 @@ class _ExternalFunctionState:
         :param pulumi.Input[Sequence[pulumi.Input[str]]] context_headers: Binds Snowflake context function results to HTTP headers.
         :param pulumi.Input[str] created_on: Date and time when the external function was created.
         :param pulumi.Input[str] database: The database in which to create the external function.
+        :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[Sequence[pulumi.Input['ExternalFunctionHeaderArgs']]] headers: Allows users to specify key-value metadata that is sent with every request as HTTP headers.
         :param pulumi.Input[int] max_batch_rows: This specifies the maximum number of rows in each batch sent to the proxy service.
-        :param pulumi.Input[str] name: Argument name
+        :param pulumi.Input[str] name: Specifies the identifier for the external function. The identifier can contain the schema name and database name, as well as the function name. The function's signature (name and argument data types) must be unique within the schema.
         :param pulumi.Input[str] null_input_behavior: Specifies the behavior of the external function when called with null inputs.
         :param pulumi.Input[str] request_translator: This specifies the name of the request translator function
         :param pulumi.Input[str] response_translator: This specifies the name of the response translator function.
@@ -343,6 +350,8 @@ class _ExternalFunctionState:
             pulumi.set(__self__, "created_on", created_on)
         if database is not None:
             pulumi.set(__self__, "database", database)
+        if fully_qualified_name is not None:
+            pulumi.set(__self__, "fully_qualified_name", fully_qualified_name)
         if headers is not None:
             pulumi.set(__self__, "headers", headers)
         if max_batch_rows is not None:
@@ -450,6 +459,18 @@ class _ExternalFunctionState:
     def database(self, value: Optional[pulumi.Input[str]]):
         pulumi.set(self, "database", 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 headers(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['ExternalFunctionHeaderArgs']]]]:
@@ -478,7 +499,7 @@ class _ExternalFunctionState:
     @pulumi.getter
     def name(self) -> Optional[pulumi.Input[str]]:
         """
-        Argument name
+        Specifies the identifier for the external function. The identifier can contain the schema name and database name, as well as the function name. The function's signature (name and argument data types) must be unique within the schema.
         """
         return pulumi.get(self, "name")
 
@@ -589,12 +610,12 @@ class ExternalFunction(pulumi.CustomResource):
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
                  api_integration: Optional[pulumi.Input[str]] = None,
-                 args: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['ExternalFunctionArgArgs']]]]] = None,
+                 args: Optional[pulumi.Input[Sequence[pulumi.Input[Union['ExternalFunctionArgArgs', 'ExternalFunctionArgArgsDict']]]]] = None,
                  comment: Optional[pulumi.Input[str]] = None,
                  compression: Optional[pulumi.Input[str]] = None,
                  context_headers: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                  database: Optional[pulumi.Input[str]] = None,
-                 headers: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['ExternalFunctionHeaderArgs']]]]] = None,
+                 headers: Optional[pulumi.Input[Sequence[pulumi.Input[Union['ExternalFunctionHeaderArgs', 'ExternalFunctionHeaderArgsDict']]]]] = None,
                  max_batch_rows: Optional[pulumi.Input[int]] = None,
                  name: Optional[pulumi.Input[str]] = None,
                  null_input_behavior: Optional[pulumi.Input[str]] = None,
@@ -607,50 +628,25 @@ class ExternalFunction(pulumi.CustomResource):
                  url_of_proxy_and_resource: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        ## Example Usage
-
-        ```python
-        import pulumi
-        import pulumi_snowflake as snowflake
-
-        test_ext_func = snowflake.ExternalFunction("testExtFunc",
-            api_integration="api_integration_name",
-            args=[
-                snowflake.ExternalFunctionArgArgs(
-                    name="arg1",
-                    type="varchar",
-                ),
-                snowflake.ExternalFunctionArgArgs(
-                    name="arg2",
-                    type="varchar",
-                ),
-            ],
-            database="my_test_db",
-            return_behavior="IMMUTABLE",
-            return_type="variant",
-            schema="my_test_schema",
-            url_of_proxy_and_resource="https://123456.execute-api.us-west-2.amazonaws.com/prod/test_func")
-        ```
-
         ## Import
 
-        format is database name | schema name | external function name | <list of function arg types, separated with '-'>
+        format is <database_name>.<schema_name>.<external_function_name>(<arg types, separated with ','>)
 
         ```sh
-        $ pulumi import snowflake:index/externalFunction:ExternalFunction example 'dbName|schemaName|externalFunctionName|varchar-varchar-varchar'
+        $ pulumi import snowflake:index/externalFunction:ExternalFunction example 'dbName.schemaName.externalFunctionName(varchar, varchar, varchar)'
         ```
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[str] api_integration: The name of the API integration object that should be used to authenticate the call to the proxy service.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['ExternalFunctionArgArgs']]]] args: Specifies the arguments/inputs for the external function. These should correspond to the arguments that the remote service expects.
+        :param pulumi.Input[Sequence[pulumi.Input[Union['ExternalFunctionArgArgs', 'ExternalFunctionArgArgsDict']]]] args: Specifies the arguments/inputs for the external function. These should correspond to the arguments that the remote service expects.
         :param pulumi.Input[str] comment: A description of the external function.
         :param pulumi.Input[str] compression: If specified, the JSON payload is compressed when sent from Snowflake to the proxy service, and when sent back from the proxy service to Snowflake.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] context_headers: Binds Snowflake context function results to HTTP headers.
         :param pulumi.Input[str] database: The database in which to create the external function.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['ExternalFunctionHeaderArgs']]]] headers: Allows users to specify key-value metadata that is sent with every request as HTTP headers.
+        :param pulumi.Input[Sequence[pulumi.Input[Union['ExternalFunctionHeaderArgs', 'ExternalFunctionHeaderArgsDict']]]] headers: Allows users to specify key-value metadata that is sent with every request as HTTP headers.
         :param pulumi.Input[int] max_batch_rows: This specifies the maximum number of rows in each batch sent to the proxy service.
-        :param pulumi.Input[str] name: Argument name
+        :param pulumi.Input[str] name: Specifies the identifier for the external function. The identifier can contain the schema name and database name, as well as the function name. The function's signature (name and argument data types) must be unique within the schema.
         :param pulumi.Input[str] null_input_behavior: Specifies the behavior of the external function when called with null inputs.
         :param pulumi.Input[str] request_translator: This specifies the name of the request translator function
         :param pulumi.Input[str] response_translator: This specifies the name of the response translator function.
@@ -667,37 +663,12 @@ class ExternalFunction(pulumi.CustomResource):
                  args: ExternalFunctionArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        ## Example Usage
-
-        ```python
-        import pulumi
-        import pulumi_snowflake as snowflake
-
-        test_ext_func = snowflake.ExternalFunction("testExtFunc",
-            api_integration="api_integration_name",
-            args=[
-                snowflake.ExternalFunctionArgArgs(
-                    name="arg1",
-                    type="varchar",
-                ),
-                snowflake.ExternalFunctionArgArgs(
-                    name="arg2",
-                    type="varchar",
-                ),
-            ],
-            database="my_test_db",
-            return_behavior="IMMUTABLE",
-            return_type="variant",
-            schema="my_test_schema",
-            url_of_proxy_and_resource="https://123456.execute-api.us-west-2.amazonaws.com/prod/test_func")
-        ```
-
         ## Import
 
-        format is database name | schema name | external function name | <list of function arg types, separated with '-'>
+        format is <database_name>.<schema_name>.<external_function_name>(<arg types, separated with ','>)
 
         ```sh
-        $ pulumi import snowflake:index/externalFunction:ExternalFunction example 'dbName|schemaName|externalFunctionName|varchar-varchar-varchar'
+        $ pulumi import snowflake:index/externalFunction:ExternalFunction example 'dbName.schemaName.externalFunctionName(varchar, varchar, varchar)'
         ```
 
         :param str resource_name: The name of the resource.
@@ -716,12 +687,12 @@ class ExternalFunction(pulumi.CustomResource):
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
                  api_integration: Optional[pulumi.Input[str]] = None,
-                 args: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['ExternalFunctionArgArgs']]]]] = None,
+                 args: Optional[pulumi.Input[Sequence[pulumi.Input[Union['ExternalFunctionArgArgs', 'ExternalFunctionArgArgsDict']]]]] = None,
                  comment: Optional[pulumi.Input[str]] = None,
                  compression: Optional[pulumi.Input[str]] = None,
                  context_headers: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                  database: Optional[pulumi.Input[str]] = None,
-                 headers: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['ExternalFunctionHeaderArgs']]]]] = None,
+                 headers: Optional[pulumi.Input[Sequence[pulumi.Input[Union['ExternalFunctionHeaderArgs', 'ExternalFunctionHeaderArgsDict']]]]] = None,
                  max_batch_rows: Optional[pulumi.Input[int]] = None,
                  name: Optional[pulumi.Input[str]] = None,
                  null_input_behavior: Optional[pulumi.Input[str]] = None,
@@ -771,6 +742,7 @@ class ExternalFunction(pulumi.CustomResource):
                 raise TypeError("Missing required property 'url_of_proxy_and_resource'")
             __props__.__dict__["url_of_proxy_and_resource"] = url_of_proxy_and_resource
             __props__.__dict__["created_on"] = None
+            __props__.__dict__["fully_qualified_name"] = None
         super(ExternalFunction, __self__).__init__(
             'snowflake:index/externalFunction:ExternalFunction',
             resource_name,
@@ -782,13 +754,14 @@ class ExternalFunction(pulumi.CustomResource):
             id: pulumi.Input[str],
             opts: Optional[pulumi.ResourceOptions] = None,
             api_integration: Optional[pulumi.Input[str]] = None,
-            args: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['ExternalFunctionArgArgs']]]]] = None,
+            args: Optional[pulumi.Input[Sequence[pulumi.Input[Union['ExternalFunctionArgArgs', 'ExternalFunctionArgArgsDict']]]]] = None,
             comment: Optional[pulumi.Input[str]] = None,
             compression: Optional[pulumi.Input[str]] = None,
             context_headers: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
             created_on: Optional[pulumi.Input[str]] = None,
             database: Optional[pulumi.Input[str]] = None,
-            headers: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['ExternalFunctionHeaderArgs']]]]] = None,
+            fully_qualified_name: Optional[pulumi.Input[str]] = None,
+            headers: Optional[pulumi.Input[Sequence[pulumi.Input[Union['ExternalFunctionHeaderArgs', 'ExternalFunctionHeaderArgsDict']]]]] = None,
             max_batch_rows: Optional[pulumi.Input[int]] = None,
             name: Optional[pulumi.Input[str]] = None,
             null_input_behavior: Optional[pulumi.Input[str]] = None,
@@ -807,15 +780,16 @@ class ExternalFunction(pulumi.CustomResource):
         :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[str] api_integration: The name of the API integration object that should be used to authenticate the call to the proxy service.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['ExternalFunctionArgArgs']]]] args: Specifies the arguments/inputs for the external function. These should correspond to the arguments that the remote service expects.
+        :param pulumi.Input[Sequence[pulumi.Input[Union['ExternalFunctionArgArgs', 'ExternalFunctionArgArgsDict']]]] args: Specifies the arguments/inputs for the external function. These should correspond to the arguments that the remote service expects.
         :param pulumi.Input[str] comment: A description of the external function.
         :param pulumi.Input[str] compression: If specified, the JSON payload is compressed when sent from Snowflake to the proxy service, and when sent back from the proxy service to Snowflake.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] context_headers: Binds Snowflake context function results to HTTP headers.
         :param pulumi.Input[str] created_on: Date and time when the external function was created.
         :param pulumi.Input[str] database: The database in which to create the external function.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['ExternalFunctionHeaderArgs']]]] headers: Allows users to specify key-value metadata that is sent with every request as HTTP headers.
+        :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[Sequence[pulumi.Input[Union['ExternalFunctionHeaderArgs', 'ExternalFunctionHeaderArgsDict']]]] headers: Allows users to specify key-value metadata that is sent with every request as HTTP headers.
         :param pulumi.Input[int] max_batch_rows: This specifies the maximum number of rows in each batch sent to the proxy service.
-        :param pulumi.Input[str] name: Argument name
+        :param pulumi.Input[str] name: Specifies the identifier for the external function. The identifier can contain the schema name and database name, as well as the function name. The function's signature (name and argument data types) must be unique within the schema.
         :param pulumi.Input[str] null_input_behavior: Specifies the behavior of the external function when called with null inputs.
         :param pulumi.Input[str] request_translator: This specifies the name of the request translator function
         :param pulumi.Input[str] response_translator: This specifies the name of the response translator function.
@@ -836,6 +810,7 @@ class ExternalFunction(pulumi.CustomResource):
         __props__.__dict__["context_headers"] = context_headers
         __props__.__dict__["created_on"] = created_on
         __props__.__dict__["database"] = database
+        __props__.__dict__["fully_qualified_name"] = fully_qualified_name
         __props__.__dict__["headers"] = headers
         __props__.__dict__["max_batch_rows"] = max_batch_rows
         __props__.__dict__["name"] = name
@@ -905,6 +880,14 @@ class ExternalFunction(pulumi.CustomResource):
         """
         return pulumi.get(self, "database")
 
+    @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 headers(self) -> pulumi.Output[Optional[Sequence['outputs.ExternalFunctionHeader']]]:
@@ -925,7 +908,7 @@ class ExternalFunction(pulumi.CustomResource):
     @pulumi.getter
     def name(self) -> pulumi.Output[str]:
         """
-        Argument name
+        Specifies the identifier for the external function. The identifier can contain the schema name and database name, as well as the function name. The function's signature (name and argument data types) must be unique within the schema.
         """
         return pulumi.get(self, "name")