Merge pull request #275 from stackql/feature/provider-docs

snowflake updates

Author: jeffreyaven

docs/snowflake-docs/providers/snowflake/account/accounts/index.md

@@ -231,13 +231,22 @@ SELECT
       value: string
     - name: name
       value: string
-      description: A Snowflake object identifier. If the identifier contains spaces or special characters, the entire string must be enclosed in double quotes. Identifiers enclosed in double quotes are also case-sensitive.
+      description: >-
+        A Snowflake object identifier. If the identifier contains spaces or
+        special characters, the entire string must be enclosed in double quotes.
+        Identifiers enclosed in double quotes are also case-sensitive.
     - name: region_group
       value: string
-      description: Region group where the account is located. Note - This column is only displayed for organizations that span multiple region groups.
+      description: >-
+        Region group where the account is located. Note - This column is only
+        displayed for organizations that span multiple region groups.
     - name: region
       value: string
-      description: Snowflake Region where the account is located. A Snowflake Region is a distinct location within a cloud platform region that is isolated from other Snowflake Regions. A Snowflake Region can be either multi-tenant or single-tenant (for a Virtual Private Snowflake account).
+      description: >-
+        Snowflake Region where the account is located. A Snowflake Region is a
+        distinct location within a cloud platform region that is isolated from
+        other Snowflake Regions. A Snowflake Region can be either multi-tenant
+        or single-tenant (for a Virtual Private Snowflake account).
     - name: edition
       value: string
       description: Snowflake Edition of the account.
@@ -267,7 +276,9 @@ SELECT
       description: Email address of the account administrator.
     - name: must_change_password
       value: boolean
-      description: Indicates whether the account administrator must change the password at the next login.
+      description: >-
+        Indicates whether the account administrator must change the password at
+        the next login.
     - name: polaris
       value: boolean
       description: Indicates whether the account is a Polaris account.

docs/snowflake-docs/providers/snowflake/alert/alerts/index.md

@@ -231,7 +231,9 @@ SELECT
       description: The warehouse the alert runs in
     - name: condition
       value: string
-      description: The SQL statement that must be evaluated to determine whether to trigger the alert
+      description: >-
+        The SQL statement that must be evaluated to determine whether to trigger
+        the alert
     - name: action
       value: string
       description: The SQL statement to execute when the alert is triggered

docs/snowflake-docs/providers/snowflake/api_integration/api_integrations/index.md

@@ -190,10 +190,14 @@ SELECT
           description: Type of ApiHook, can be AWS, AZURE, GC or GIT.
     - name: api_allowed_prefixes
       value: array
-      description: A comma-separated list of endpoints and resources that Snowflake can access.
+      description: >-
+        A comma-separated list of endpoints and resources that Snowflake can
+        access.
     - name: api_blocked_prefixes
       value: array
-      description: A comma-separated list of endpoints and resources that are not allowed to be called from Snowflake.
+      description: >-
+        A comma-separated list of endpoints and resources that are not allowed
+        to be called from Snowflake.
     - name: enabled
       value: boolean
       description: Whether the API integration is enabled.

docs/snowflake-docs/providers/snowflake/compute_pool/compute_pools/index.md

@@ -236,7 +236,10 @@ SELECT
       value: string
     - name: name
       value: string
-      description: A Snowflake object identifier. If the identifier contains spaces or special characters, the entire string must be enclosed in double quotes. Identifiers enclosed in double quotes are also case-sensitive.
+      description: >-
+        A Snowflake object identifier. If the identifier contains spaces or
+        special characters, the entire string must be enclosed in double quotes.
+        Identifiers enclosed in double quotes are also case-sensitive.
     - name: min_nodes
       value: integer
       description: Minimum number of nodes for the compute pool.
@@ -248,7 +251,9 @@ SELECT
       description: Instance family for the compute pool.
     - name: auto_resume
       value: boolean
-      description: Whether Snowflake automatically resumes the compute pool when any statement that requires the compute pool is submitted.
+      description: >-
+        Whether Snowflake automatically resumes the compute pool when any
+        statement that requires the compute pool is submitted.
     - name: comment
       value: string
       description: Comment describing the compute pool.

docs/snowflake-docs/providers/snowflake/database/databases/index.md

@@ -250,7 +250,10 @@ SELECT
       value: string
     - name: name
       value: string
-      description: A Snowflake object identifier. If the identifier contains spaces or special characters, the entire string must be enclosed in double quotes. Identifiers enclosed in double quotes are also case-sensitive.
+      description: >-
+        A Snowflake object identifier. If the identifier contains spaces or
+        special characters, the entire string must be enclosed in double quotes.
+        Identifiers enclosed in double quotes are also case-sensitive.
     - name: kind
       value: string
       description: Database type, permanent (default) or transient.
@@ -259,34 +262,60 @@ SELECT
       description: Optional comment in which to store information related to the database.
     - name: data_retention_time_in_days
       value: integer
-      description: Specifies the number of days for which Time Travel actions (CLONE and UNDROP) can be performed on the database, as well as specifying the default Time Travel retention time for all schemas created in the database.
+      description: >-
+        Specifies the number of days for which Time Travel actions (CLONE and
+        UNDROP) can be performed on the database, as well as specifying the
+        default Time Travel retention time for all schemas created in the
+        database.
     - name: default_ddl_collation
       value: string
-      description: Default collation specification for all schemas and tables added to the database. You an override the default at the schema and individual table levels.
+      description: >-
+        Default collation specification for all schemas and tables added to the
+        database. You an override the default at the schema and individual table
+        levels.
     - name: log_level
       value: string
-      description: Severity level of messages that should be ingested and made available in the active event table. Currently, Snowflake supports only `TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`, `FATAL` and `OFF`.
+      description: >-
+        Severity level of messages that should be ingested and made available in
+        the active event table. Currently, Snowflake supports only `TRACE`,
+        `DEBUG`, `INFO`, `WARN`, `ERROR`, `FATAL` and `OFF`.
     - name: max_data_extension_time_in_days
       value: integer
-      description: Maximum number of days for which Snowflake can extend the data retention period for tables in the database to prevent streams on the tables from becoming stale.
+      description: >-
+        Maximum number of days for which Snowflake can extend the data retention
+        period for tables in the database to prevent streams on the tables from
+        becoming stale.
     - name: suspend_task_after_num_failures
       value: integer
-      description: Maximum number of consecutive failed task runs before the current task is suspended automatically.
+      description: >-
+        Maximum number of consecutive failed task runs before the current task
+        is suspended automatically.
     - name: trace_level
       value: string
-      description: How trace events are ingested into the event table. Currently, Snowflake supports only `ALWAYS`, `ON_EVENT`, and `OFF`.
+      description: >-
+        How trace events are ingested into the event table. Currently, Snowflake
+        supports only `ALWAYS`, `ON_EVENT`, and `OFF`.
     - name: user_task_managed_initial_warehouse_size
       value: string
-      description: Size of the compute resources to provision for the first run of the serverless task, before a task history is available for Snowflake to determine an ideal size.
+      description: >-
+        Size of the compute resources to provision for the first run of the
+        serverless task, before a task history is available for Snowflake to
+        determine an ideal size.
     - name: serverless_task_min_statement_size
       value: string
-      description: Specifies the minimum allowed warehouse size for the serverless task. Minimum XSMALL, Maximum XXLARGE.
+      description: >-
+        Specifies the minimum allowed warehouse size for the serverless task.
+        Minimum XSMALL, Maximum XXLARGE.
     - name: serverless_task_max_statement_size
       value: string
-      description: Specifies the maximum allowed warehouse size for the serverless task. Minimum XSMALL, Maximum XXLARGE.
+      description: >-
+        Specifies the maximum allowed warehouse size for the serverless task.
+        Minimum XSMALL, Maximum XXLARGE.
     - name: user_task_timeout_ms
       value: integer
-      description: Time limit, in milliseconds, for a single run of the task before it times out.
+      description: >-
+        Time limit, in milliseconds, for a single run of the task before it
+        times out.
 
 ```
 </TabItem>

docs/snowflake-docs/providers/snowflake/database_role/future_grants/index.md

@@ -175,7 +175,9 @@ SELECT
       description: Type of the securable to be granted.
     - name: grant_option
       value: boolean
-      description: If true, allows the recipient role to grant the privileges to other roles.
+      description: >-
+        If true, allows the recipient role to grant the privileges to other
+        roles.
     - name: privileges
       value: array
       description: List of privileges to be granted.

docs/snowflake-docs/providers/snowflake/database_role/grants/index.md

@@ -175,7 +175,9 @@ SELECT
       description: Type of the securable to be granted.
     - name: grant_option
       value: boolean
-      description: If true, allows the recipient role to grant the privileges to other roles.
+      description: >-
+        If true, allows the recipient role to grant the privileges to other
+        roles.
     - name: privileges
       value: array
       description: List of privileges to be granted.

docs/snowflake-docs/providers/snowflake/dynamic_table/dynamic_tables/index.md

@@ -269,7 +269,9 @@ SELECT
       value: string
     - name: name
       value: string
-      description: Specifies the name for the dynamic table, must be unique for the schema in which the dynamic table is created
+      description: >-
+        Specifies the name for the dynamic table, must be unique for the schema
+        in which the dynamic table is created
     - name: kind
       value: string
       description: Specifies the dynamic table type, permanent (default) or transient.
@@ -298,19 +300,29 @@ SELECT
       description: Specifies the behavior of the initial refresh of the dynamic table
     - name: warehouse
       value: string
-      description: Specifies the name of the warehouse that provides the compute resources for refreshing the dynamic table
+      description: >-
+        Specifies the name of the warehouse that provides the compute resources
+        for refreshing the dynamic table
     - name: cluster_by
       value: array
-      description: Specifies one or more columns or column expressions in the dynamic table as the clustering key
+      description: >-
+        Specifies one or more columns or column expressions in the dynamic table
+        as the clustering key
     - name: query
       value: string
       description: Specifies the query whose results the dynamic table should contain
     - name: data_retention_time_in_days
       value: integer
-      description: Specifies the retention period for the dynamic table so that Time Travel actions (SELECT, CLONE) can be performed on historical data in the dynamic table
+      description: >-
+        Specifies the retention period for the dynamic table so that Time Travel
+        actions (SELECT, CLONE) can be performed on historical data in the
+        dynamic table
     - name: max_data_extension_time_in_days
       value: integer
-      description: Specifies the retention period for the dynamic table so that Time Travel actions (SELECT, CLONE) can be performed on historical data in the dynamic table
+      description: >-
+        Specifies the retention period for the dynamic table so that Time Travel
+        actions (SELECT, CLONE) can be performed on historical data in the
+        dynamic table
     - name: comment
       value: string
       description: Specifies a comment for the dynamic table.

docs/snowflake-docs/providers/snowflake/event_table/event_tables/index.md

@@ -237,13 +237,19 @@ SELECT
       description: number of days to retain the old version of deleted/updated data
     - name: max_data_extension_time_in_days
       value: integer
-      description: Maximum number of days to extend data retention beyond the retention period to prevent a stream becoming stale.
+      description: >-
+        Maximum number of days to extend data retention beyond the retention
+        period to prevent a stream becoming stale.
     - name: change_tracking
       value: boolean
-      description: True if change tracking is enabled, allowing streams and CHANGES to be used on the entity.
+      description: >-
+        True if change tracking is enabled, allowing streams and CHANGES to be
+        used on the entity.
     - name: default_ddl_collation
       value: string
-      description: Collation that is used for all the new columns created by the DDL statements (if not specified)
+      description: >-
+        Collation that is used for all the new columns created by the DDL
+        statements (if not specified)
     - name: comment
       value: string
       description: user comment associated to an object in the dictionary

docs/snowflake-docs/providers/snowflake/external_volume/external_volumes/index.md

@@ -170,18 +170,25 @@ SELECT
       value: string
     - name: name
       value: string
-      description: String that specifies the identifier (the name) for the external volume; must be unique in your account.
+      description: >-
+        String that specifies the identifier (the name) for the external volume;
+        must be unique in your account.
     - name: storage_locations
       value:
         - name: name
           value: string
         - name: storage_provider
           value: string
           description: Specifies the cloud storage provider that stores your data files.
-      description: Set of named cloud storage locations in different regions and, optionally, cloud platforms.
+      description: >-
+        Set of named cloud storage locations in different regions and,
+        optionally, cloud platforms.
     - name: allow_writes
       value: boolean
-      description: Specifies whether write operations are allowed for the external volume; must be set to TRUE for Iceberg tables that use Snowflake as the catalog.
+      description: >-
+        Specifies whether write operations are allowed for the external volume;
+        must be set to TRUE for Iceberg tables that use Snowflake as the
+        catalog.
     - name: comment
       value: string
       description: String (literal) that specifies a comment for the external volume.