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

snowflake updates

Author: jeffreyaven

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

@@ -220,16 +220,9 @@ SELECT
 # Description fields below are for documentation purposes only and are not required in the manifest
 - name: accounts
   props:
-    - name: data__admin_name
-      value: string
-    - name: data__edition
-      value: string
-    - name: data__email
-      value: string
-    - name: data__name
-      value: string
     - name: endpoint
       value: string
+      description: Required parameter for the accounts resource.
     - name: name
       value: string
       description: >-
@@ -250,7 +243,9 @@ SELECT
         or single-tenant (for a Virtual Private Snowflake account).
     - name: edition
       value: string
-      description: Snowflake Edition of the account.
+      description: >-
+        Snowflake Edition of the account. (valid values: 'STANDARD',
+        'ENTERPRISE', 'BUSINESS_CRITICAL')
     - name: comment
       value: string
       description: Optional comment in which to store information related to the account.
@@ -280,9 +275,11 @@ SELECT
       description: >-
         Indicates whether the account administrator must change the password at
         the next login.
+      default: false
     - name: polaris
       value: boolean
       description: Indicates whether the account is a Polaris account.
+      default: false
 ```
 </TabItem>
 </Tabs>

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

@@ -204,18 +204,13 @@ SELECT
   props:
     - name: database_name
       value: string
+      description: Required parameter for the alerts resource.
     - name: schema_name
       value: string
-    - name: data__action
-      value: string
-    - name: data__condition
-      value: string
-    - name: data__name
-      value: string
-    - name: data__schedule
-      value: string
+      description: Required parameter for the alerts resource.
     - name: endpoint
       value: string
+      description: Required parameter for the alerts resource.
     - name: name
       value: string
       description: Name of the alert

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

@@ -171,24 +171,19 @@ SELECT
 # Description fields below are for documentation purposes only and are not required in the manifest
 - name: api_integrations
   props:
-    - name: data__api_allowed_prefixes
-      value: string
-    - name: data__api_hook
-      value: string
-    - name: data__enabled
-      value: string
-    - name: data__name
-      value: string
     - name: endpoint
       value: string
+      description: Required parameter for the api_integrations resource.
     - name: name
       value: string
       description: Name of the API integration.
     - name: api_hook
       value:
         - name: type
           value: string
-          description: Type of ApiHook, can be AWS, AZURE, GC or GIT.
+          description: >-
+            Type of ApiHook, can be AWS, AZURE, GC or GIT. (valid values: 'AWS',
+            'AZURE', 'GC', 'GIT')
     - name: api_allowed_prefixes
       value: array
       description: >-

docs/snowflake-docs/providers/snowflake/catalog_integration/catalog_integrations/index.md

@@ -171,27 +171,22 @@ SELECT
 # Description fields below are for documentation purposes only and are not required in the manifest
 - name: catalog_integrations
   props:
-    - name: data__catalog
-      value: string
-    - name: data__enabled
-      value: string
-    - name: data__name
-      value: string
-    - name: data__table_format
-      value: string
     - name: endpoint
       value: string
+      description: Required parameter for the catalog_integrations resource.
     - name: name
       value: string
       description: Name of the catalog integration.
     - name: catalog
       value:
         - name: catalog_source
           value: string
-          description: Type of external catalog
+          description: >-
+            Type of external catalog (valid values: 'GLUE', 'OBJECT_STORE',
+            'POLARIS')
     - name: table_format
       value: string
-      description: Table format of the catalog.
+      description: 'Table format of the catalog. (valid values: ''ICEBERG'')'
     - name: enabled
       value: boolean
       description: whether this catalog integration is available to use for Iceberg tables.

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

@@ -225,16 +225,9 @@ SELECT
 # Description fields below are for documentation purposes only and are not required in the manifest
 - name: compute_pools
   props:
-    - name: data__instance_family
-      value: string
-    - name: data__max_nodes
-      value: string
-    - name: data__min_nodes
-      value: string
-    - name: data__name
-      value: string
     - name: endpoint
       value: string
+      description: Required parameter for the compute_pools resource.
     - name: name
       value: string
       description: >-

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

@@ -245,10 +245,9 @@ SELECT
 # Description fields below are for documentation purposes only and are not required in the manifest
 - name: databases
   props:
-    - name: data__name
-      value: string
     - name: endpoint
       value: string
+      description: Required parameter for the databases resource.
     - name: name
       value: string
       description: >-
@@ -257,7 +256,10 @@ SELECT
         Identifiers enclosed in double quotes are also case-sensitive.
     - name: kind
       value: string
-      description: Database type, permanent (default) or transient.
+      description: >-
+        Database type, permanent (default) or transient. (valid values:
+        'PERMANENT', 'TRANSIENT')
+      default: PERMANENT
     - name: comment
       value: string
       description: Optional comment in which to store information related to the database.

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

@@ -138,10 +138,10 @@ SELECT
   props:
     - name: database_name
       value: string
-    - name: data__name
-      value: string
+      description: Required parameter for the database_roles resource.
     - name: endpoint
       value: string
+      description: Required parameter for the database_roles resource.
     - name: name
       value: string
       description: Name of the database role

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

@@ -143,12 +143,13 @@ SELECT
   props:
     - name: database_name
       value: string
+      description: Required parameter for the future_grants resource.
     - name: name
       value: string
-    - name: data__securable_type
-      value: string
+      description: Required parameter for the future_grants resource.
     - name: endpoint
       value: string
+      description: Required parameter for the future_grants resource.
     - name: securable
       value:
         - name: database

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

@@ -143,12 +143,13 @@ SELECT
   props:
     - name: database_name
       value: string
+      description: Required parameter for the grants resource.
     - name: name
       value: string
-    - name: data__securable_type
-      value: string
+      description: Required parameter for the grants resource.
     - name: endpoint
       value: string
+      description: Required parameter for the grants resource.
     - name: securable
       value:
         - name: database

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

@@ -256,26 +256,24 @@ SELECT
   props:
     - name: database_name
       value: string
+      description: Required parameter for the dynamic_tables resource.
     - name: schema_name
       value: string
-    - name: data__name
-      value: string
-    - name: data__query
-      value: string
-    - name: data__target_lag
-      value: string
-    - name: data__warehouse
-      value: string
+      description: Required parameter for the dynamic_tables resource.
     - name: endpoint
       value: string
+      description: Required parameter for the dynamic_tables resource.
     - 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
     - name: kind
       value: string
-      description: Specifies the dynamic table type, permanent (default) or transient.
+      description: >-
+        Specifies the dynamic table type, permanent (default) or transient.
+        (valid values: 'PERMANENT', 'TRANSIENT')
+      default: PERMANENT
     - name: columns
       value:
         - name: name
@@ -295,10 +293,14 @@ SELECT
       description: Specifies the schedule for periodically refreshing the dynamic table.
     - name: refresh_mode
       value: string
-      description: Specifies the refresh type for the dynamic table
+      description: >-
+        Specifies the refresh type for the dynamic table (valid values: 'AUTO',
+        'FULL', 'INCREMENTAL')
     - name: initialize
       value: string
-      description: Specifies the behavior of the initial refresh of the dynamic table
+      description: >-
+        Specifies the behavior of the initial refresh of the dynamic table
+        (valid values: 'ON_CREATE', 'ON_SCHEDULE')
     - name: warehouse
       value: string
       description: >-

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

@@ -221,12 +221,13 @@ SELECT
   props:
     - name: database_name
       value: string
+      description: Required parameter for the event_tables resource.
     - name: schema_name
       value: string
-    - name: data__name
-      value: string
+      description: Required parameter for the event_tables resource.
     - name: endpoint
       value: string
+      description: Required parameter for the event_tables resource.
     - name: name
       value: string
       description: Name of the event table

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

@@ -163,12 +163,9 @@ SELECT
 # Description fields below are for documentation purposes only and are not required in the manifest
 - name: external_volumes
   props:
-    - name: data__name
-      value: string
-    - name: data__storage_locations
-      value: string
     - name: endpoint
       value: string
+      description: Required parameter for the external_volumes resource.
     - name: name
       value: string
       description: >-
@@ -180,7 +177,9 @@ SELECT
           value: string
         - name: storage_provider
           value: string
-          description: Specifies the cloud storage provider that stores your data files.
+          description: >-
+            Specifies the cloud storage provider that stores your data files.
+            (valid values: 'S3', 'S3GOV', 'GCS', 'AZURE')
       description: >-
         Set of named cloud storage locations in different regions and,
         optionally, cloud platforms.

docs/snowflake-docs/providers/snowflake/function/functions/index.md

@@ -193,16 +193,16 @@ SELECT
   props:
     - name: database_name
       value: string
+      description: Required parameter for the functions resource.
     - name: schema_name
       value: string
-    - name: data__arguments
-      value: string
-    - name: data__name
-      value: string
+      description: Required parameter for the functions resource.
     - name: endpoint
       value: string
+      description: Required parameter for the functions resource.
     - name: function_type
       value: string
+      default: service-function
     - name: name
       value: string
       description: >-
@@ -215,13 +215,21 @@ SELECT
           description: Argument's name
         - name: datatype
           value: string
-          description: Argument's type
+          description: >-
+            Argument's type (valid values: 'FIXED', 'INT', 'REAL', 'NUMBER',
+            'TEXT', 'BOOLEAN', 'DATE', 'TIME', 'TIMESTAMP_TZ', 'TIMESTAMP_LTZ',
+            'TIMESTAMP_NTZ')
+          default: TEXT
         - name: value
           value: string
           description: Argument's value
     - name: returns
       value: string
-      description: Specifies the type for the function return value.
+      description: >-
+        Specifies the type for the function return value. (valid values:
+        'FIXED', 'INT', 'REAL', 'NUMBER', 'TEXT', 'BOOLEAN', 'DATE', 'TIME',
+        'TIMESTAMP_TZ', 'TIMESTAMP_LTZ', 'TIMESTAMP_NTZ')
+      default: TEXT
     - name: max_batch_rows
       value: integer
       description: Specifies the max rows for batch operation.

docs/snowflake-docs/providers/snowflake/grant/privileges/index.md

@@ -131,14 +131,19 @@ SELECT
   props:
     - name: granteeName
       value: string
+      description: Required parameter for the privileges resource.
     - name: granteeType
       value: string
+      description: Required parameter for the privileges resource.
     - name: securableName
       value: string
+      description: Required parameter for the privileges resource.
     - name: securableType
       value: string
+      description: Required parameter for the privileges resource.
     - name: endpoint
       value: string
+      description: Required parameter for the privileges resource.
     - name: privileges
       value: array
       description: Privilege type

docs/snowflake-docs/providers/snowflake/iceberg_table/iceberg_tables/index.md

@@ -274,12 +274,13 @@ SELECT
   props:
     - name: database_name
       value: string
+      description: Required parameter for the iceberg_tables resource.
     - name: schema_name
       value: string
-    - name: data__name
-      value: string
+      description: Required parameter for the iceberg_tables resource.
     - name: endpoint
       value: string
+      description: Required parameter for the iceberg_tables resource.
     - name: name
       value: string
       description: Name of the iceberg table
@@ -314,7 +315,8 @@ SELECT
       value: string
       description: >-
         Storage serialization policy used for managed Iceberg table. This
-        include encodings and compressions
+        include encodings and compressions (valid values: 'COMPATIBLE',
+        'OPTIMIZED')
     - name: catalog_table_name
       value: string
       description: Name of the table as recognized by the catalog.