pulumi-snowflake 0.50.3a1710160126__py3-none-any.whl → 1.2.0a1736849992__py3-none-any.whl

pulumi_snowflake/get_databases.py

@@ -4,11 +4,17 @@
 
 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 *
 
 __all__ = [
     'GetDatabasesResult',
@@ -22,73 +28,84 @@ class GetDatabasesResult:
     """
     A collection of values returned by getDatabases.
     """
-    def __init__(__self__, databases=None, history=None, id=None, pattern=None, starts_with=None, terse=None):
+    def __init__(__self__, databases=None, id=None, like=None, limit=None, starts_with=None, with_describe=None, with_parameters=None):
         if databases and not isinstance(databases, list):
             raise TypeError("Expected argument 'databases' to be a list")
         pulumi.set(__self__, "databases", databases)
-        if history and not isinstance(history, bool):
-            raise TypeError("Expected argument 'history' to be a bool")
-        pulumi.set(__self__, "history", history)
         if id and not isinstance(id, str):
             raise TypeError("Expected argument 'id' to be a str")
         pulumi.set(__self__, "id", id)
-        if pattern and not isinstance(pattern, str):
-            raise TypeError("Expected argument 'pattern' to be a str")
-        pulumi.set(__self__, "pattern", pattern)
+        if like and not isinstance(like, str):
+            raise TypeError("Expected argument 'like' to be a str")
+        pulumi.set(__self__, "like", like)
+        if limit and not isinstance(limit, dict):
+            raise TypeError("Expected argument 'limit' to be a dict")
+        pulumi.set(__self__, "limit", limit)
         if starts_with and not isinstance(starts_with, str):
             raise TypeError("Expected argument 'starts_with' to be a str")
         pulumi.set(__self__, "starts_with", starts_with)
-        if terse and not isinstance(terse, bool):
-            raise TypeError("Expected argument 'terse' to be a bool")
-        pulumi.set(__self__, "terse", terse)
+        if with_describe and not isinstance(with_describe, bool):
+            raise TypeError("Expected argument 'with_describe' to be a bool")
+        pulumi.set(__self__, "with_describe", with_describe)
+        if with_parameters and not isinstance(with_parameters, bool):
+            raise TypeError("Expected argument 'with_parameters' to be a bool")
+        pulumi.set(__self__, "with_parameters", with_parameters)
 
     @property
     @pulumi.getter
     def databases(self) -> Sequence['outputs.GetDatabasesDatabaseResult']:
         """
-        Snowflake databases
+        Holds the aggregated output of all database details queries.
         """
         return pulumi.get(self, "databases")
 
     @property
     @pulumi.getter
-    def history(self) -> Optional[bool]:
+    def id(self) -> str:
         """
-        Optionally includes dropped databases that have not yet been purged The output also includes an additional `dropped_on` column
+        The provider-assigned unique ID for this managed resource.
         """
-        return pulumi.get(self, "history")
+        return pulumi.get(self, "id")
 
     @property
     @pulumi.getter
-    def id(self) -> str:
+    def like(self) -> Optional[str]:
         """
-        The provider-assigned unique ID for this managed resource.
+        Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
         """
-        return pulumi.get(self, "id")
+        return pulumi.get(self, "like")
 
     @property
     @pulumi.getter
-    def pattern(self) -> Optional[str]:
+    def limit(self) -> Optional['outputs.GetDatabasesLimitResult']:
         """
-        Optionally filters the databases by a pattern
+        Limits the number of rows returned. If the `limit.from` is set, then the limit wll start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern with `starts_with` or `like`.
         """
-        return pulumi.get(self, "pattern")
+        return pulumi.get(self, "limit")
 
     @property
     @pulumi.getter(name="startsWith")
     def starts_with(self) -> Optional[str]:
         """
-        Optionally filters the databases by a pattern
+        Filters the output with **case-sensitive** characters indicating the beginning of the object name.
         """
         return pulumi.get(self, "starts_with")
 
     @property
-    @pulumi.getter
-    def terse(self) -> Optional[bool]:
+    @pulumi.getter(name="withDescribe")
+    def with_describe(self) -> Optional[bool]:
         """
-        Optionally returns only the columns `created_on` and `name` in the results
+        Runs DESC DATABASE for each database returned by SHOW DATABASES. The output of describe is saved to the description field. By default this value is set to true.
         """
-        return pulumi.get(self, "terse")
+        return pulumi.get(self, "with_describe")
+
+    @property
+    @pulumi.getter(name="withParameters")
+    def with_parameters(self) -> Optional[bool]:
+        """
+        Runs SHOW PARAMETERS FOR DATABASE for each database returned by SHOW DATABASES. The output of describe is saved to the parameters field as a map. By default this value is set to true.
+        """
+        return pulumi.get(self, "with_parameters")
 
 
 class AwaitableGetDatabasesResult(GetDatabasesResult):
@@ -98,75 +115,76 @@ class AwaitableGetDatabasesResult(GetDatabasesResult):
             yield self
         return GetDatabasesResult(
             databases=self.databases,
-            history=self.history,
             id=self.id,
-            pattern=self.pattern,
+            like=self.like,
+            limit=self.limit,
             starts_with=self.starts_with,
-            terse=self.terse)
+            with_describe=self.with_describe,
+            with_parameters=self.with_parameters)
 
 
-def get_databases(history: Optional[bool] = None,
-                  pattern: Optional[str] = None,
+def get_databases(like: Optional[str] = None,
+                  limit: Optional[Union['GetDatabasesLimitArgs', 'GetDatabasesLimitArgsDict']] = None,
                   starts_with: Optional[str] = None,
-                  terse: Optional[bool] = None,
+                  with_describe: Optional[bool] = None,
+                  with_parameters: Optional[bool] = None,
                   opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetDatabasesResult:
     """
-    ## Example Usage
-
-    <!--Start PulumiCodeChooser -->
-    ```python
-    import pulumi
-    import pulumi_snowflake as snowflake
-
-    this = snowflake.get_databases()
-    ```
-    <!--End PulumiCodeChooser -->
+    Data source used to get details of filtered databases. Filtering is aligned with the current possibilities for [SHOW DATABASES](https://docs.snowflake.com/en/sql-reference/sql/show-databases) query (`like`, `starts_with`, and `limit` are all supported). The results of SHOW, DESCRIBE, and SHOW PARAMETERS IN are encapsulated in one output collection.
 
 
-    :param bool history: Optionally includes dropped databases that have not yet been purged The output also includes an additional `dropped_on` column
-    :param str pattern: Optionally filters the databases by a pattern
-    :param str starts_with: Optionally filters the databases by a pattern
-    :param bool terse: Optionally returns only the columns `created_on` and `name` in the results
+    :param str like: Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
+    :param Union['GetDatabasesLimitArgs', 'GetDatabasesLimitArgsDict'] limit: Limits the number of rows returned. If the `limit.from` is set, then the limit wll start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern with `starts_with` or `like`.
+    :param str starts_with: Filters the output with **case-sensitive** characters indicating the beginning of the object name.
+    :param bool with_describe: Runs DESC DATABASE for each database returned by SHOW DATABASES. The output of describe is saved to the description field. By default this value is set to true.
+    :param bool with_parameters: Runs SHOW PARAMETERS FOR DATABASE for each database returned by SHOW DATABASES. The output of describe is saved to the parameters field as a map. By default this value is set to true.
     """
     __args__ = dict()
-    __args__['history'] = history
-    __args__['pattern'] = pattern
+    __args__['like'] = like
+    __args__['limit'] = limit
     __args__['startsWith'] = starts_with
-    __args__['terse'] = terse
+    __args__['withDescribe'] = with_describe
+    __args__['withParameters'] = with_parameters
     opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke('snowflake:index/getDatabases:getDatabases', __args__, opts=opts, typ=GetDatabasesResult).value
 
     return AwaitableGetDatabasesResult(
         databases=pulumi.get(__ret__, 'databases'),
-        history=pulumi.get(__ret__, 'history'),
         id=pulumi.get(__ret__, 'id'),
-        pattern=pulumi.get(__ret__, 'pattern'),
+        like=pulumi.get(__ret__, 'like'),
+        limit=pulumi.get(__ret__, 'limit'),
         starts_with=pulumi.get(__ret__, 'starts_with'),
-        terse=pulumi.get(__ret__, 'terse'))
-
-
-@_utilities.lift_output_func(get_databases)
-def get_databases_output(history: Optional[pulumi.Input[Optional[bool]]] = None,
-                         pattern: Optional[pulumi.Input[Optional[str]]] = None,
+        with_describe=pulumi.get(__ret__, 'with_describe'),
+        with_parameters=pulumi.get(__ret__, 'with_parameters'))
+def get_databases_output(like: Optional[pulumi.Input[Optional[str]]] = None,
+                         limit: Optional[pulumi.Input[Optional[Union['GetDatabasesLimitArgs', 'GetDatabasesLimitArgsDict']]]] = None,
                          starts_with: Optional[pulumi.Input[Optional[str]]] = None,
-                         terse: Optional[pulumi.Input[Optional[bool]]] = None,
-                         opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetDatabasesResult]:
+                         with_describe: Optional[pulumi.Input[Optional[bool]]] = None,
+                         with_parameters: Optional[pulumi.Input[Optional[bool]]] = None,
+                         opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetDatabasesResult]:
     """
-    ## Example Usage
+    Data source used to get details of filtered databases. Filtering is aligned with the current possibilities for [SHOW DATABASES](https://docs.snowflake.com/en/sql-reference/sql/show-databases) query (`like`, `starts_with`, and `limit` are all supported). The results of SHOW, DESCRIBE, and SHOW PARAMETERS IN are encapsulated in one output collection.
 
-    <!--Start PulumiCodeChooser -->
-    ```python
-    import pulumi
-    import pulumi_snowflake as snowflake
 
-    this = snowflake.get_databases()
-    ```
-    <!--End PulumiCodeChooser -->
-
-
-    :param bool history: Optionally includes dropped databases that have not yet been purged The output also includes an additional `dropped_on` column
-    :param str pattern: Optionally filters the databases by a pattern
-    :param str starts_with: Optionally filters the databases by a pattern
-    :param bool terse: Optionally returns only the columns `created_on` and `name` in the results
+    :param str like: Filters the output with **case-insensitive** pattern, with support for SQL wildcard characters (`%` and `_`).
+    :param Union['GetDatabasesLimitArgs', 'GetDatabasesLimitArgsDict'] limit: Limits the number of rows returned. If the `limit.from` is set, then the limit wll start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern with `starts_with` or `like`.
+    :param str starts_with: Filters the output with **case-sensitive** characters indicating the beginning of the object name.
+    :param bool with_describe: Runs DESC DATABASE for each database returned by SHOW DATABASES. The output of describe is saved to the description field. By default this value is set to true.
+    :param bool with_parameters: Runs SHOW PARAMETERS FOR DATABASE for each database returned by SHOW DATABASES. The output of describe is saved to the parameters field as a map. By default this value is set to true.
     """
-    ...
+    __args__ = dict()
+    __args__['like'] = like
+    __args__['limit'] = limit
+    __args__['startsWith'] = starts_with
+    __args__['withDescribe'] = with_describe
+    __args__['withParameters'] = with_parameters
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('snowflake:index/getDatabases:getDatabases', __args__, opts=opts, typ=GetDatabasesResult)
+    return __ret__.apply(lambda __response__: GetDatabasesResult(
+        databases=pulumi.get(__response__, 'databases'),
+        id=pulumi.get(__response__, 'id'),
+        like=pulumi.get(__response__, 'like'),
+        limit=pulumi.get(__response__, 'limit'),
+        starts_with=pulumi.get(__response__, 'starts_with'),
+        with_describe=pulumi.get(__response__, 'with_describe'),
+        with_parameters=pulumi.get(__response__, 'with_parameters')))

pulumi_snowflake/get_dynamic_tables.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 *
@@ -106,17 +111,18 @@ class AwaitableGetDynamicTablesResult(GetDynamicTablesResult):
             starts_with=self.starts_with)
 
 
-def get_dynamic_tables(in_: Optional[pulumi.InputType['GetDynamicTablesInArgs']] = None,
-                       like: Optional[pulumi.InputType['GetDynamicTablesLikeArgs']] = None,
-                       limit: Optional[pulumi.InputType['GetDynamicTablesLimitArgs']] = None,
+def get_dynamic_tables(in_: Optional[Union['GetDynamicTablesInArgs', 'GetDynamicTablesInArgsDict']] = None,
+                       like: Optional[Union['GetDynamicTablesLikeArgs', 'GetDynamicTablesLikeArgsDict']] = None,
+                       limit: Optional[Union['GetDynamicTablesLimitArgs', 'GetDynamicTablesLimitArgsDict']] = None,
                        starts_with: Optional[str] = None,
                        opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetDynamicTablesResult:
     """
-    Use this data source to access information about an existing resource.
+    !> **Caution: Preview Feature** This feature is considered a preview feature in the provider, regardless of the state of the resource in Snowflake. We do not guarantee its stability. It will be reworked and marked as a stable feature in future releases. Breaking changes are expected, even without bumping the major version. To use this feature, add the relevant feature name to `preview_features_enabled field` in the provider configuration. Please always refer to the Getting Help section in our Github repo to best determine how to get help for your questions.
 
-    :param pulumi.InputType['GetDynamicTablesInArgs'] in_: IN clause to filter the list of dynamic tables.
-    :param pulumi.InputType['GetDynamicTablesLikeArgs'] like: LIKE clause to filter the list of dynamic tables.
-    :param pulumi.InputType['GetDynamicTablesLimitArgs'] limit: Optionally limits the maximum number of rows returned, while also enabling “pagination” of the results. Note that the actual number of rows returned might be less than the specified limit (e.g. the number of existing objects is less than the specified limit).
+
+    :param Union['GetDynamicTablesInArgs', 'GetDynamicTablesInArgsDict'] in_: IN clause to filter the list of dynamic tables.
+    :param Union['GetDynamicTablesLikeArgs', 'GetDynamicTablesLikeArgsDict'] like: LIKE clause to filter the list of dynamic tables.
+    :param Union['GetDynamicTablesLimitArgs', 'GetDynamicTablesLimitArgsDict'] limit: Optionally limits the maximum number of rows returned, while also enabling “pagination” of the results. Note that the actual number of rows returned might be less than the specified limit (e.g. the number of existing objects is less than the specified limit).
     :param str starts_with: Optionally filters the command output based on the characters that appear at the beginning of the object name. The string is case-sensitive.
     """
     __args__ = dict()
@@ -134,20 +140,31 @@ def get_dynamic_tables(in_: Optional[pulumi.InputType['GetDynamicTablesInArgs']]
         limit=pulumi.get(__ret__, 'limit'),
         records=pulumi.get(__ret__, 'records'),
         starts_with=pulumi.get(__ret__, 'starts_with'))
-
-
-@_utilities.lift_output_func(get_dynamic_tables)
-def get_dynamic_tables_output(in_: Optional[pulumi.Input[Optional[pulumi.InputType['GetDynamicTablesInArgs']]]] = None,
-                              like: Optional[pulumi.Input[Optional[pulumi.InputType['GetDynamicTablesLikeArgs']]]] = None,
-                              limit: Optional[pulumi.Input[Optional[pulumi.InputType['GetDynamicTablesLimitArgs']]]] = None,
+def get_dynamic_tables_output(in_: Optional[pulumi.Input[Optional[Union['GetDynamicTablesInArgs', 'GetDynamicTablesInArgsDict']]]] = None,
+                              like: Optional[pulumi.Input[Optional[Union['GetDynamicTablesLikeArgs', 'GetDynamicTablesLikeArgsDict']]]] = None,
+                              limit: Optional[pulumi.Input[Optional[Union['GetDynamicTablesLimitArgs', 'GetDynamicTablesLimitArgsDict']]]] = None,
                               starts_with: Optional[pulumi.Input[Optional[str]]] = None,
-                              opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetDynamicTablesResult]:
+                              opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetDynamicTablesResult]:
     """
-    Use this data source to access information about an existing resource.
+    !> **Caution: Preview Feature** This feature is considered a preview feature in the provider, regardless of the state of the resource in Snowflake. We do not guarantee its stability. It will be reworked and marked as a stable feature in future releases. Breaking changes are expected, even without bumping the major version. To use this feature, add the relevant feature name to `preview_features_enabled field` in the provider configuration. Please always refer to the Getting Help section in our Github repo to best determine how to get help for your questions.
 
-    :param pulumi.InputType['GetDynamicTablesInArgs'] in_: IN clause to filter the list of dynamic tables.
-    :param pulumi.InputType['GetDynamicTablesLikeArgs'] like: LIKE clause to filter the list of dynamic tables.
-    :param pulumi.InputType['GetDynamicTablesLimitArgs'] limit: Optionally limits the maximum number of rows returned, while also enabling “pagination” of the results. Note that the actual number of rows returned might be less than the specified limit (e.g. the number of existing objects is less than the specified limit).
+
+    :param Union['GetDynamicTablesInArgs', 'GetDynamicTablesInArgsDict'] in_: IN clause to filter the list of dynamic tables.
+    :param Union['GetDynamicTablesLikeArgs', 'GetDynamicTablesLikeArgsDict'] like: LIKE clause to filter the list of dynamic tables.
+    :param Union['GetDynamicTablesLimitArgs', 'GetDynamicTablesLimitArgsDict'] limit: Optionally limits the maximum number of rows returned, while also enabling “pagination” of the results. Note that the actual number of rows returned might be less than the specified limit (e.g. the number of existing objects is less than the specified limit).
     :param str starts_with: Optionally filters the command output based on the characters that appear at the beginning of the object name. The string is case-sensitive.
     """
-    ...
+    __args__ = dict()
+    __args__['in'] = in_
+    __args__['like'] = like
+    __args__['limit'] = limit
+    __args__['startsWith'] = starts_with
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('snowflake:index/getDynamicTables:getDynamicTables', __args__, opts=opts, typ=GetDynamicTablesResult)
+    return __ret__.apply(lambda __response__: GetDynamicTablesResult(
+        id=pulumi.get(__response__, 'id'),
+        in_=pulumi.get(__response__, 'in_'),
+        like=pulumi.get(__response__, 'like'),
+        limit=pulumi.get(__response__, 'limit'),
+        records=pulumi.get(__response__, 'records'),
+        starts_with=pulumi.get(__response__, 'starts_with')))

pulumi_snowflake/get_external_functions.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
 
@@ -85,9 +90,10 @@ def get_external_functions(database: Optional[str] = None,
                            schema: Optional[str] = None,
                            opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetExternalFunctionsResult:
     """
+    !> **Caution: Preview Feature** This feature is considered a preview feature in the provider, regardless of the state of the resource in Snowflake. We do not guarantee its stability. It will be reworked and marked as a stable feature in future releases. Breaking changes are expected, even without bumping the major version. To use this feature, add the relevant feature name to `preview_features_enabled field` in the provider configuration. Please always refer to the Getting Help section in our Github repo to best determine how to get help for your questions.
+
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_snowflake as snowflake
@@ -95,7 +101,10 @@ def get_external_functions(database: Optional[str] = None,
     current = snowflake.get_external_functions(database="MYDB",
         schema="MYSCHEMA")
     ```
-    <!--End PulumiCodeChooser -->
+
+
+    :param str database: The database from which to return the schemas from.
+    :param str schema: The schema from which to return the external functions from.
     """
     __args__ = dict()
     __args__['database'] = database
@@ -108,16 +117,14 @@ def get_external_functions(database: Optional[str] = None,
         external_functions=pulumi.get(__ret__, 'external_functions'),
         id=pulumi.get(__ret__, 'id'),
         schema=pulumi.get(__ret__, 'schema'))
-
-
-@_utilities.lift_output_func(get_external_functions)
 def get_external_functions_output(database: Optional[pulumi.Input[Optional[str]]] = None,
                                   schema: Optional[pulumi.Input[Optional[str]]] = None,
-                                  opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetExternalFunctionsResult]:
+                                  opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetExternalFunctionsResult]:
     """
+    !> **Caution: Preview Feature** This feature is considered a preview feature in the provider, regardless of the state of the resource in Snowflake. We do not guarantee its stability. It will be reworked and marked as a stable feature in future releases. Breaking changes are expected, even without bumping the major version. To use this feature, add the relevant feature name to `preview_features_enabled field` in the provider configuration. Please always refer to the Getting Help section in our Github repo to best determine how to get help for your questions.
+
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_snowflake as snowflake
@@ -125,6 +132,18 @@ def get_external_functions_output(database: Optional[pulumi.Input[Optional[str]]
     current = snowflake.get_external_functions(database="MYDB",
         schema="MYSCHEMA")
     ```
-    <!--End PulumiCodeChooser -->
+
+
+    :param str database: The database from which to return the schemas from.
+    :param str schema: The schema from which to return the external functions from.
     """
-    ...
+    __args__ = dict()
+    __args__['database'] = database
+    __args__['schema'] = schema
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('snowflake:index/getExternalFunctions:getExternalFunctions', __args__, opts=opts, typ=GetExternalFunctionsResult)
+    return __ret__.apply(lambda __response__: GetExternalFunctionsResult(
+        database=pulumi.get(__response__, 'database'),
+        external_functions=pulumi.get(__response__, 'external_functions'),
+        id=pulumi.get(__response__, 'id'),
+        schema=pulumi.get(__response__, 'schema')))

pulumi_snowflake/get_external_tables.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
 
@@ -85,9 +90,10 @@ def get_external_tables(database: Optional[str] = None,
                         schema: Optional[str] = None,
                         opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetExternalTablesResult:
     """
+    !> **Caution: Preview Feature** This feature is considered a preview feature in the provider, regardless of the state of the resource in Snowflake. We do not guarantee its stability. It will be reworked and marked as a stable feature in future releases. Breaking changes are expected, even without bumping the major version. To use this feature, add the relevant feature name to `preview_features_enabled field` in the provider configuration. Please always refer to the Getting Help section in our Github repo to best determine how to get help for your questions.
+
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_snowflake as snowflake
@@ -95,7 +101,10 @@ def get_external_tables(database: Optional[str] = None,
     current = snowflake.get_external_tables(database="MYDB",
         schema="MYSCHEMA")
     ```
-    <!--End PulumiCodeChooser -->
+
+
+    :param str database: The database from which to return the schemas from.
+    :param str schema: The schema from which to return the external tables from.
     """
     __args__ = dict()
     __args__['database'] = database
@@ -108,16 +117,14 @@ def get_external_tables(database: Optional[str] = None,
         external_tables=pulumi.get(__ret__, 'external_tables'),
         id=pulumi.get(__ret__, 'id'),
         schema=pulumi.get(__ret__, 'schema'))
-
-
-@_utilities.lift_output_func(get_external_tables)
 def get_external_tables_output(database: Optional[pulumi.Input[str]] = None,
                                schema: Optional[pulumi.Input[str]] = None,
-                               opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetExternalTablesResult]:
+                               opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetExternalTablesResult]:
     """
+    !> **Caution: Preview Feature** This feature is considered a preview feature in the provider, regardless of the state of the resource in Snowflake. We do not guarantee its stability. It will be reworked and marked as a stable feature in future releases. Breaking changes are expected, even without bumping the major version. To use this feature, add the relevant feature name to `preview_features_enabled field` in the provider configuration. Please always refer to the Getting Help section in our Github repo to best determine how to get help for your questions.
+
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_snowflake as snowflake
@@ -125,6 +132,18 @@ def get_external_tables_output(database: Optional[pulumi.Input[str]] = None,
     current = snowflake.get_external_tables(database="MYDB",
         schema="MYSCHEMA")
     ```
-    <!--End PulumiCodeChooser -->
+
+
+    :param str database: The database from which to return the schemas from.
+    :param str schema: The schema from which to return the external tables from.
     """
-    ...
+    __args__ = dict()
+    __args__['database'] = database
+    __args__['schema'] = schema
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('snowflake:index/getExternalTables:getExternalTables', __args__, opts=opts, typ=GetExternalTablesResult)
+    return __ret__.apply(lambda __response__: GetExternalTablesResult(
+        database=pulumi.get(__response__, 'database'),
+        external_tables=pulumi.get(__response__, 'external_tables'),
+        id=pulumi.get(__response__, 'id'),
+        schema=pulumi.get(__response__, 'schema')))

pulumi_snowflake/get_failover_groups.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
 
@@ -72,7 +77,8 @@ class AwaitableGetFailoverGroupsResult(GetFailoverGroupsResult):
 def get_failover_groups(in_account: Optional[str] = None,
                         opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetFailoverGroupsResult:
     """
-    Use this data source to access information about an existing resource.
+    !> **Caution: Preview Feature** This feature is considered a preview feature in the provider, regardless of the state of the resource in Snowflake. We do not guarantee its stability. It will be reworked and marked as a stable feature in future releases. Breaking changes are expected, even without bumping the major version. To use this feature, add the relevant feature name to `preview_features_enabled field` in the provider configuration. Please always refer to the Getting Help section in our Github repo to best determine how to get help for your questions.
+
 
     :param str in_account: Specifies the identifier for the account
     """
@@ -85,14 +91,19 @@ def get_failover_groups(in_account: Optional[str] = None,
         failover_groups=pulumi.get(__ret__, 'failover_groups'),
         id=pulumi.get(__ret__, 'id'),
         in_account=pulumi.get(__ret__, 'in_account'))
-
-
-@_utilities.lift_output_func(get_failover_groups)
 def get_failover_groups_output(in_account: Optional[pulumi.Input[Optional[str]]] = None,
-                               opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetFailoverGroupsResult]:
+                               opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetFailoverGroupsResult]:
     """
-    Use this data source to access information about an existing resource.
+    !> **Caution: Preview Feature** This feature is considered a preview feature in the provider, regardless of the state of the resource in Snowflake. We do not guarantee its stability. It will be reworked and marked as a stable feature in future releases. Breaking changes are expected, even without bumping the major version. To use this feature, add the relevant feature name to `preview_features_enabled field` in the provider configuration. Please always refer to the Getting Help section in our Github repo to best determine how to get help for your questions.
+
 
     :param str in_account: Specifies the identifier for the account
     """
-    ...
+    __args__ = dict()
+    __args__['inAccount'] = in_account
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('snowflake:index/getFailoverGroups:getFailoverGroups', __args__, opts=opts, typ=GetFailoverGroupsResult)
+    return __ret__.apply(lambda __response__: GetFailoverGroupsResult(
+        failover_groups=pulumi.get(__response__, 'failover_groups'),
+        id=pulumi.get(__response__, 'id'),
+        in_account=pulumi.get(__response__, 'in_account')))

pulumi_snowflake/get_file_formats.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
 
@@ -85,9 +90,10 @@ def get_file_formats(database: Optional[str] = None,
                      schema: Optional[str] = None,
                      opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetFileFormatsResult:
     """
+    !> **Caution: Preview Feature** This feature is considered a preview feature in the provider, regardless of the state of the resource in Snowflake. We do not guarantee its stability. It will be reworked and marked as a stable feature in future releases. Breaking changes are expected, even without bumping the major version. To use this feature, add the relevant feature name to `preview_features_enabled field` in the provider configuration. Please always refer to the Getting Help section in our Github repo to best determine how to get help for your questions.
+
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_snowflake as snowflake
@@ -95,7 +101,10 @@ def get_file_formats(database: Optional[str] = None,
     current = snowflake.get_file_formats(database="MYDB",
         schema="MYSCHEMA")
     ```
-    <!--End PulumiCodeChooser -->
+
+
+    :param str database: The database from which to return the schemas from.
+    :param str schema: The schema from which to return the file formats from.
     """
     __args__ = dict()
     __args__['database'] = database
@@ -108,16 +117,14 @@ def get_file_formats(database: Optional[str] = None,
         file_formats=pulumi.get(__ret__, 'file_formats'),
         id=pulumi.get(__ret__, 'id'),
         schema=pulumi.get(__ret__, 'schema'))
-
-
-@_utilities.lift_output_func(get_file_formats)
 def get_file_formats_output(database: Optional[pulumi.Input[str]] = None,
                             schema: Optional[pulumi.Input[str]] = None,
-                            opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetFileFormatsResult]:
+                            opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetFileFormatsResult]:
     """
+    !> **Caution: Preview Feature** This feature is considered a preview feature in the provider, regardless of the state of the resource in Snowflake. We do not guarantee its stability. It will be reworked and marked as a stable feature in future releases. Breaking changes are expected, even without bumping the major version. To use this feature, add the relevant feature name to `preview_features_enabled field` in the provider configuration. Please always refer to the Getting Help section in our Github repo to best determine how to get help for your questions.
+
     ## Example Usage
 
-    <!--Start PulumiCodeChooser -->
     ```python
     import pulumi
     import pulumi_snowflake as snowflake
@@ -125,6 +132,18 @@ def get_file_formats_output(database: Optional[pulumi.Input[str]] = None,
     current = snowflake.get_file_formats(database="MYDB",
         schema="MYSCHEMA")
     ```
-    <!--End PulumiCodeChooser -->
+
+
+    :param str database: The database from which to return the schemas from.
+    :param str schema: The schema from which to return the file formats from.
     """
-    ...
+    __args__ = dict()
+    __args__['database'] = database
+    __args__['schema'] = schema
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('snowflake:index/getFileFormats:getFileFormats', __args__, opts=opts, typ=GetFileFormatsResult)
+    return __ret__.apply(lambda __response__: GetFileFormatsResult(
+        database=pulumi.get(__response__, 'database'),
+        file_formats=pulumi.get(__response__, 'file_formats'),
+        id=pulumi.get(__response__, 'id'),
+        schema=pulumi.get(__response__, 'schema')))