diff --git a/package-lock.json b/package-lock.json index 5bed565..0299258 100644 --- a/package-lock.json +++ b/package-lock.json @@ -8,7 +8,7 @@ "name": "stackql-provider-snowflake", "version": "0.1.0", "dependencies": { - "@stackql/provider-utils": "^0.1.4" + "@stackql/provider-utils": "^0.2.2" }, "engines": { "node": ">=14.16.0" @@ -80,9 +80,9 @@ } }, "node_modules/@stackql/provider-utils": { - "version": "0.1.4", - "resolved": "https://registry.npmjs.org/@stackql/provider-utils/-/provider-utils-0.1.4.tgz", - "integrity": "sha512-wf/RkjvjY5rDkEV8eQ5JDqVrJRBMWOb0e35A7hUnsYy32HjqZGP/hkVA8KL/n4Iq2j0aBvNTHzsrZidRyQRSew==", + "version": "0.2.2", + "resolved": "https://registry.npmjs.org/@stackql/provider-utils/-/provider-utils-0.2.2.tgz", + "integrity": "sha512-8t+p4TWQI7dXUuPQLEg55T2ZCDNRytph/MdWfRrnuyBkro3XAYEn4NF4qAnYOLq14+JHzk1eLgDb//hGMyUJOQ==", "license": "MIT", "dependencies": { "@apidevtools/swagger-parser": "^10.1.1", diff --git a/package.json b/package.json index 87f336b..8c25803 100644 --- a/package.json +++ b/package.json @@ -8,7 +8,7 @@ "test": "echo \"Error: no test specified\" && exit 1" }, "dependencies": { - "@stackql/provider-utils": "^0.1.4" + "@stackql/provider-utils": "^0.2.2" }, "engines": { "node": ">=14.16.0" diff --git a/website/docs/index.md b/website/docs/index.md index 481c9db..9cdab08 100644 --- a/website/docs/index.md +++ b/website/docs/index.md @@ -73,43 +73,43 @@ stackql.exe shell --auth=$Auth ## Services
-account
-alert
-api_integration
-catalog_integration
-compute_pool
-cortex_analyst
-cortex_inference
-cortex_search_service
-database
-database_role
-dynamic_table
-event_table
-external_volume
-function
-grant
-iceberg_table
-image_repository
-managed_account
+account
+alert
+api_integration
+catalog_integration
+compute_pool
+cortex_analyst
+cortex_inference
+cortex_search_service
+database
+database_role
+dynamic_table
+event_table
+external_volume
+function
+grant
+iceberg_table
+image_repository
+managed_account
-network_policy
-notebook
-notification_integration
-pipe
-procedure
-result
-role
-schema
-service
-sqlapi
-stage
-streams
-table
-task
-user
-user_defined_function
-view
-warehouse
+network_policy
+notebook
+notification_integration
+pipe
+procedure
+result
+role
+schema
+service
+sqlapi
+stage
+streams
+table
+task
+user
+user_defined_function
+view
+warehouse
diff --git a/website/docs/account/accounts/index.md b/website/docs/services/account/accounts/index.md similarity index 94% rename from website/docs/account/accounts/index.md rename to website/docs/services/account/accounts/index.md index f10d73d..9e60be8 100644 --- a/website/docs/account/accounts/index.md +++ b/website/docs/services/account/accounts/index.md @@ -39,7 +39,7 @@ The following fields are returned by `SELECT` queries: > -Snowflake account object. +Successful request. @@ -53,7 +53,7 @@ Snowflake account object. - + @@ -279,7 +279,7 @@ The following methods are available for this resource: - + @@ -327,7 +327,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -466,7 +466,7 @@ SELECT - 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. + User-defined name that identifies an account within the organization. - name: region_group value: string diff --git a/website/docs/account/index.md b/website/docs/services/account/index.md similarity index 91% rename from website/docs/account/index.md rename to website/docs/services/account/index.md index 2a7e901..2a30a46 100644 --- a/website/docs/account/index.md +++ b/website/docs/services/account/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/alert/alerts/index.md b/website/docs/services/alert/alerts/index.md similarity index 93% rename from website/docs/alert/alerts/index.md rename to website/docs/services/alert/alerts/index.md index 88f5ec9..d629cc5 100644 --- a/website/docs/alert/alerts/index.md +++ b/website/docs/services/alert/alerts/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake alert +successful
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)User-defined name that identifies an account within the organization. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
name, gracePeriodInDays, endpoint ifExistsDeletes the specified account. If you enable the ifExists parameter, the operation succeeds even if the account does not exist. Otherwise, a 404 failure is returned if the account does not exist. if the drop is unsuccessful.Deletes the specified account. If you enable the `ifExists` parameter, the operation succeeds even if the account does not exist. Otherwise, a 404 failure is returned if the account does not exist. if the drop is unsuccessful.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -99,7 +99,7 @@ A Snowflake alert - + @@ -116,7 +116,7 @@ A Snowflake alert -A Snowflake alert +successful
objectThe schedule the alert runs under
@@ -175,7 +175,7 @@ A Snowflake alert - + @@ -268,7 +268,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -283,7 +283,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -298,7 +298,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -308,7 +308,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -460,6 +460,9 @@ SELECT - name: schedule value: object + description: > + The schedule the alert runs under + - name: warehouse value: string description: > diff --git a/website/docs/alert/index.md b/website/docs/services/alert/index.md similarity index 92% rename from website/docs/alert/index.md rename to website/docs/services/alert/index.md index 8551599..b74b717 100644 --- a/website/docs/alert/index.md +++ b/website/docs/services/alert/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/api_integration/api_integrations/index.md b/website/docs/services/api_integration/api_integrations/index.md similarity index 92% rename from website/docs/api_integration/api_integrations/index.md rename to website/docs/services/api_integration/api_integrations/index.md index 6bd37ea..0915bc7 100644 --- a/website/docs/api_integration/api_integrations/index.md +++ b/website/docs/services/api_integration/api_integrations/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake API integration object. +successful
objectThe schedule the alert runs under
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -54,7 +54,7 @@ A Snowflake API integration object. - + @@ -91,7 +91,7 @@ A Snowflake API integration object. -A Snowflake API integration object. +successful
stringName of the API integration. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the API integration. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
@@ -105,7 +105,7 @@ A Snowflake API integration object. - + @@ -221,12 +221,12 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + - + diff --git a/website/docs/api_integration/index.md b/website/docs/services/api_integration/index.md similarity index 88% rename from website/docs/api_integration/index.md rename to website/docs/services/api_integration/index.md index aaae7c7..5053118 100644 --- a/website/docs/api_integration/index.md +++ b/website/docs/services/api_integration/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/catalog_integration/catalog_integrations/index.md b/website/docs/services/catalog_integration/catalog_integrations/index.md similarity index 91% rename from website/docs/catalog_integration/catalog_integrations/index.md rename to website/docs/services/catalog_integration/catalog_integrations/index.md index 5e39429..b052b21 100644 --- a/website/docs/catalog_integration/catalog_integrations/index.md +++ b/website/docs/services/catalog_integration/catalog_integrations/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -Catalog integration +successful
stringName of the API integration. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the API integration. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -54,12 +54,12 @@ Catalog integration - + - + @@ -96,7 +96,7 @@ Catalog integration -Catalog integration +successful
stringName of the catalog integration. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the catalog integration. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
objectType of catalog and its parameters.
@@ -110,12 +110,12 @@ Catalog integration - + - + @@ -224,12 +224,12 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + - + @@ -339,6 +339,9 @@ SELECT - name: catalog value: object + description: > + Type of catalog and its parameters. + - name: table_format value: string description: > diff --git a/website/docs/catalog_integration/index.md b/website/docs/services/catalog_integration/index.md similarity index 86% rename from website/docs/catalog_integration/index.md rename to website/docs/services/catalog_integration/index.md index 62b8fb4..9cd614e 100644 --- a/website/docs/catalog_integration/index.md +++ b/website/docs/services/catalog_integration/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/compute_pool/compute_pools/index.md b/website/docs/services/compute_pool/compute_pools/index.md similarity index 94% rename from website/docs/compute_pool/compute_pools/index.md rename to website/docs/services/compute_pool/compute_pools/index.md index e0cbc44..c1af17d 100644 --- a/website/docs/compute_pool/compute_pools/index.md +++ b/website/docs/services/compute_pool/compute_pools/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake compute pool definition. +Successful request.
stringName of the catalog integration. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the catalog integration. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
objectType of catalog and its parameters.
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -54,7 +54,7 @@ A Snowflake compute pool definition. - + @@ -166,7 +166,7 @@ A Snowflake compute pool definition. -A Snowflake compute pool definition. +Successful request.
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
@@ -180,7 +180,7 @@ A Snowflake compute pool definition. - + @@ -319,7 +319,7 @@ The following methods are available for this resource: - + @@ -340,7 +340,7 @@ The following methods are available for this resource: - + @@ -399,12 +399,12 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + - + diff --git a/website/docs/compute_pool/index.md b/website/docs/services/compute_pool/index.md similarity index 89% rename from website/docs/compute_pool/index.md rename to website/docs/services/compute_pool/index.md index 62d06a2..8d34702 100644 --- a/website/docs/compute_pool/index.md +++ b/website/docs/services/compute_pool/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/cortex_analyst/feedback/index.md b/website/docs/services/cortex_analyst/feedback/index.md similarity index 100% rename from website/docs/cortex_analyst/feedback/index.md rename to website/docs/services/cortex_analyst/feedback/index.md diff --git a/website/docs/cortex_analyst/index.md b/website/docs/services/cortex_analyst/index.md similarity index 68% rename from website/docs/cortex_analyst/index.md rename to website/docs/services/cortex_analyst/index.md index cebc257..e82913a 100644 --- a/website/docs/cortex_analyst/index.md +++ b/website/docs/services/cortex_analyst/index.md @@ -25,11 +25,11 @@ total resources: __4__ ## Resources \ No newline at end of file diff --git a/website/docs/cortex_analyst/messages/index.md b/website/docs/services/cortex_analyst/messages/index.md similarity index 100% rename from website/docs/cortex_analyst/messages/index.md rename to website/docs/services/cortex_analyst/messages/index.md diff --git a/website/docs/cortex_analyst/query_suggestions/index.md b/website/docs/services/cortex_analyst/query_suggestions/index.md similarity index 100% rename from website/docs/cortex_analyst/query_suggestions/index.md rename to website/docs/services/cortex_analyst/query_suggestions/index.md diff --git a/website/docs/cortex_analyst/tokens/index.md b/website/docs/services/cortex_analyst/tokens/index.md similarity index 100% rename from website/docs/cortex_analyst/tokens/index.md rename to website/docs/services/cortex_analyst/tokens/index.md diff --git a/website/docs/cortex_inference/completions/index.md b/website/docs/services/cortex_inference/completions/index.md similarity index 100% rename from website/docs/cortex_inference/completions/index.md rename to website/docs/services/cortex_inference/completions/index.md diff --git a/website/docs/cortex_inference/index.md b/website/docs/services/cortex_inference/index.md similarity index 82% rename from website/docs/cortex_inference/index.md rename to website/docs/services/cortex_inference/index.md index 418b314..7d03d8e 100644 --- a/website/docs/cortex_inference/index.md +++ b/website/docs/services/cortex_inference/index.md @@ -25,9 +25,9 @@ total resources: __2__ ## Resources \ No newline at end of file diff --git a/website/docs/cortex_inference/models/index.md b/website/docs/services/cortex_inference/models/index.md similarity index 100% rename from website/docs/cortex_inference/models/index.md rename to website/docs/services/cortex_inference/models/index.md diff --git a/website/docs/cortex_search_service/index.md b/website/docs/services/cortex_search_service/index.md similarity index 88% rename from website/docs/cortex_search_service/index.md rename to website/docs/services/cortex_search_service/index.md index c1229e8..d842c8d 100644 --- a/website/docs/cortex_search_service/index.md +++ b/website/docs/services/cortex_search_service/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/cortex_search_service/search_services/index.md b/website/docs/services/cortex_search_service/search_services/index.md similarity index 92% rename from website/docs/cortex_search_service/search_services/index.md rename to website/docs/services/cortex_search_service/search_services/index.md index 524204d..e0d9702 100644 --- a/website/docs/cortex_search_service/search_services/index.md +++ b/website/docs/services/cortex_search_service/search_services/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake cortex search service object. +successful
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
name, endpoint Fetches a named compute pool. You can get the name of the compute pool from the /api/v2/compute-pools GET request.Fetches a named compute pool. You can get the name of the compute pool from the `/api/v2/compute-pools` GET request.
name, endpoint ifExistsDeletes a compute pool with the given name. If you enable the ifExists parameter, the operation succeeds even if the object does not exist. Otherwise, a 404 failure is returned if the object does not exist.Deletes a compute pool with the given name. If you enable the `ifExists` parameter, the operation succeeds even if the object does not exist. Otherwise, a 404 failure is returned if the object does not exist.
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -104,7 +104,7 @@ A Snowflake cortex search service object. - + @@ -119,7 +119,7 @@ A Snowflake cortex search service object. - + @@ -129,7 +129,7 @@ A Snowflake cortex search service object. - + @@ -141,7 +141,7 @@ A Snowflake cortex search service object. -A Snowflake cortex search service object. +successful
stringCurrent state of the indexing pipeline for the cortex search service; one of 'SUSPENDED' or 'ACTIVE'.
stringWhether the cortex search service is currently actively serving; one of 'SUSPENDED' or 'ACTIVE'.
objectSpecifies the schedule for periodically refreshing the dynamic table.Specifies the schedule for periodically refreshing the cortex search service.
@@ -205,7 +205,7 @@ A Snowflake cortex search service object. - + @@ -220,7 +220,7 @@ A Snowflake cortex search service object. - + @@ -230,7 +230,7 @@ A Snowflake cortex search service object. - + @@ -325,7 +325,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -340,7 +340,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -350,7 +350,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -360,7 +360,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -540,7 +540,7 @@ SELECT - name: target_lag value: object description: > - Specifies the schedule for periodically refreshing the dynamic table. + Specifies the schedule for periodically refreshing the cortex search service. - name: warehouse value: string @@ -559,9 +559,15 @@ SELECT - name: indexing_state value: string + description: > + Current state of the indexing pipeline for the cortex search service; one of 'SUSPENDED' or 'ACTIVE'. + valid_values: ['ACTIVE', 'SUSPENDED', 'INITIALIZING'] - name: serving_state value: string + description: > + Whether the cortex search service is currently actively serving; one of 'SUSPENDED' or 'ACTIVE'. + valid_values: ['ACTIVE', 'SUSPENDED', 'INITIALIZING'] - name: createMode value: string diff --git a/website/docs/database/databases/index.md b/website/docs/services/database/databases/index.md similarity index 93% rename from website/docs/database/databases/index.md rename to website/docs/services/database/databases/index.md index 09e9c5d..c445279 100644 --- a/website/docs/database/databases/index.md +++ b/website/docs/services/database/databases/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -Snowflake database object. +Successful request.
stringCurrent state of the indexing pipeline for the cortex search service; one of 'SUSPENDED' or 'ACTIVE'.
stringWhether the cortex search service is currently actively serving; one of 'SUSPENDED' or 'ACTIVE'.
objectSpecifies the schedule for periodically refreshing the dynamic table.Specifies the schedule for periodically refreshing the cortex search service.
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -54,7 +54,7 @@ Snowflake database object. - + @@ -171,7 +171,7 @@ Snowflake database object. -Snowflake database object. +successful
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)Name of the database. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
@@ -185,7 +185,7 @@ Snowflake database object. - + @@ -350,7 +350,7 @@ The following methods are available for this resource: - + @@ -452,7 +452,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -467,17 +467,17 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + - + - + @@ -487,12 +487,12 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + - + @@ -655,7 +655,7 @@ SELECT - 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. + Name of the database. - name: kind value: string diff --git a/website/docs/database/index.md b/website/docs/services/database/index.md similarity index 91% rename from website/docs/database/index.md rename to website/docs/services/database/index.md index f6d7bd4..4743b9e 100644 --- a/website/docs/database/index.md +++ b/website/docs/services/database/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/database_role/database_roles/index.md b/website/docs/services/database_role/database_roles/index.md similarity index 89% rename from website/docs/database_role/database_roles/index.md rename to website/docs/services/database_role/database_roles/index.md index 372285d..5e5ba18 100644 --- a/website/docs/database_role/database_roles/index.md +++ b/website/docs/services/database_role/database_roles/index.md @@ -39,7 +39,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake database role +successful
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)Name of the database. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
name, endpoint ifExists, restrictDeletes the specified database. If you enable the ifExists parameter, the operation succeeds even if the database does not exist. Otherwise, a 404 failure is returned if the database does not exist. if the drop is unsuccessful.Deletes the specified database. If you enable the `ifExists` parameter, the operation succeeds even if the database does not exist. Otherwise, a 404 failure is returned if the database does not exist. if the drop is unsuccessful.
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
booleanWhether to allow replicating data to accounts on lower editions. Default: true. For more information, see the ALTER DATABASE reference.Whether to allow replicating data to accounts on lower editions. Default: `true`. For more information, see the <a href=https://docs.snowflake.com/en/sql-reference/sql/alter-database> ALTER DATABASE</a> reference.
stringType of database to create. Currently, Snowflake supports only transient and permanent (also represented by the empty string).Type of database to create. Currently, Snowflake supports only `transient` and `permanent` (also represented by the empty string).
booleanWhether to drop the database if foreign keys exist that reference any tables in the database. - true: Return a warning about existing foreign key references and don't drop the database. - false: Drop the database and all objects in the database, including tables with primary or unique keys that are referenced by foreign keys in other tables.Whether to drop the database if foreign keys exist that reference any tables in the database. - `true`: Return a warning about existing foreign key references and don't drop the database. - `false`: Drop the database and all objects in the database, including tables with primary or unique keys that are referenced by foreign keys in other tables.
stringID of the share from which to create the database, in the form "<provider_account>.<share_name>".ID of the share from which to create the database, in the form "<provider_account>.<share_name>".
@@ -53,7 +53,7 @@ A Snowflake database role - + @@ -83,12 +83,12 @@ A Snowflake database role - + - +
stringName of the database role (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the database role (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringRole that owns the database role (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Role that owns the database role (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe type of role that owns the database role (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The type of role that owns the database role (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
@@ -157,7 +157,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases. + Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases. @@ -172,7 +172,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Query parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource. + Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource. @@ -182,7 +182,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# boolean - Query parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist. + Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist. diff --git a/website/docs/database_role/future_grants/index.md b/website/docs/services/database_role/future_grants/index.md similarity index 96% rename from website/docs/database_role/future_grants/index.md rename to website/docs/services/database_role/future_grants/index.md index 89e506c..923747e 100644 --- a/website/docs/database_role/future_grants/index.md +++ b/website/docs/services/database_role/future_grants/index.md @@ -53,7 +53,7 @@ successful object - + Containing scope of the grant @@ -78,7 +78,7 @@ successful object - + Securable of the grant @@ -145,7 +145,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases. + Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases. @@ -254,8 +254,14 @@ SELECT description: Required parameter for the future_grants resource. - name: securable value: object + description: > + Securable of the grant + - name: containing_scope value: object + description: > + Containing scope of the grant + - name: securable_type value: string description: > diff --git a/website/docs/database_role/grants/index.md b/website/docs/services/database_role/grants/index.md similarity index 96% rename from website/docs/database_role/grants/index.md rename to website/docs/services/database_role/grants/index.md index 43061ab..4373ef4 100644 --- a/website/docs/database_role/grants/index.md +++ b/website/docs/services/database_role/grants/index.md @@ -53,7 +53,7 @@ successful object - + Containing scope of the grant @@ -78,7 +78,7 @@ successful object - + Securable of the grant @@ -145,7 +145,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases. + Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases. @@ -254,8 +254,14 @@ SELECT description: Required parameter for the grants resource. - name: securable value: object + description: > + Securable of the grant + - name: containing_scope value: object + description: > + Containing scope of the grant + - name: securable_type value: string description: > diff --git a/website/docs/database_role/index.md b/website/docs/services/database_role/index.md similarity index 74% rename from website/docs/database_role/index.md rename to website/docs/services/database_role/index.md index 581acfc..1031a1e 100644 --- a/website/docs/database_role/index.md +++ b/website/docs/services/database_role/index.md @@ -25,10 +25,10 @@ total resources: __3__ ## Resources \ No newline at end of file diff --git a/website/docs/dynamic_table/dynamic_tables/index.md b/website/docs/services/dynamic_table/dynamic_tables/index.md similarity index 96% rename from website/docs/dynamic_table/dynamic_tables/index.md rename to website/docs/services/dynamic_table/dynamic_tables/index.md index 6495eab..febab54 100644 --- a/website/docs/dynamic_table/dynamic_tables/index.md +++ b/website/docs/services/dynamic_table/dynamic_tables/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake dynamic table object. +successful @@ -166,7 +166,7 @@ A Snowflake dynamic table object. -A Snowflake dynamic table object. +successful
@@ -410,7 +410,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -425,7 +425,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -440,7 +440,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -455,7 +455,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + diff --git a/website/docs/dynamic_table/index.md b/website/docs/services/dynamic_table/index.md similarity index 89% rename from website/docs/dynamic_table/index.md rename to website/docs/services/dynamic_table/index.md index 2dc7f52..be9ff43 100644 --- a/website/docs/dynamic_table/index.md +++ b/website/docs/services/dynamic_table/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/event_table/event_tables/index.md b/website/docs/services/event_table/event_tables/index.md similarity index 95% rename from website/docs/event_table/event_tables/index.md rename to website/docs/services/event_table/event_tables/index.md index 3b7dcc7..8cdbbe7 100644 --- a/website/docs/event_table/event_tables/index.md +++ b/website/docs/services/event_table/event_tables/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake event table +successful
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -151,7 +151,7 @@ A Snowflake event table -A Snowflake event table +successful
@@ -331,7 +331,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -346,7 +346,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -361,7 +361,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -371,7 +371,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + diff --git a/website/docs/event_table/index.md b/website/docs/services/event_table/index.md similarity index 89% rename from website/docs/event_table/index.md rename to website/docs/services/event_table/index.md index 6745c72..e86a241 100644 --- a/website/docs/event_table/index.md +++ b/website/docs/services/event_table/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/external_volume/external_volumes/index.md b/website/docs/services/external_volume/external_volumes/index.md similarity index 89% rename from website/docs/external_volume/external_volumes/index.md rename to website/docs/services/external_volume/external_volumes/index.md index 3922d04..4e27302 100644 --- a/website/docs/external_volume/external_volumes/index.md +++ b/website/docs/services/external_volume/external_volumes/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake external volume +successful
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -54,7 +54,7 @@ A Snowflake external volume - + @@ -74,12 +74,12 @@ A Snowflake external volume - + - + @@ -91,7 +91,7 @@ A Snowflake external volume -A Snowflake external volume +successful
stringString that specifies the identifier (the name) for the external volume; must be unique in your account. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)String that specifies the identifier (the name) for the external volume; must be unique in your account. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringRole that owns the external volume (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Role that owns the external volume (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe type of role that owns the external volume (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The type of role that owns the external volume (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
@@ -105,7 +105,7 @@ A Snowflake external volume - + @@ -125,12 +125,12 @@ A Snowflake external volume - + - + @@ -221,12 +221,12 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + - + diff --git a/website/docs/external_volume/index.md b/website/docs/services/external_volume/index.md similarity index 88% rename from website/docs/external_volume/index.md rename to website/docs/services/external_volume/index.md index 0b688d3..df94f2c 100644 --- a/website/docs/external_volume/index.md +++ b/website/docs/services/external_volume/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/function/functions/index.md b/website/docs/services/function/functions/index.md similarity index 91% rename from website/docs/function/functions/index.md rename to website/docs/services/function/functions/index.md index 93ae026..d1f7847 100644 --- a/website/docs/function/functions/index.md +++ b/website/docs/services/function/functions/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake function +successful
stringString that specifies the identifier (the name) for the external volume; must be unique in your account. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)String that specifies the identifier (the name) for the external volume; must be unique in your account. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringRole that owns the external volume (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Role that owns the external volume (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe type of role that owns the external volume (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The type of role that owns the external volume (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -64,7 +64,7 @@ A Snowflake function - + @@ -79,7 +79,7 @@ A Snowflake function - + @@ -94,14 +94,14 @@ A Snowflake function - +
stringFunction's body.Function's body.
stringFunction's language.Function's language.
stringFunction's arguments.Function's arguments.
-A Snowflake function +successful @@ -125,7 +125,7 @@ A Snowflake function - + @@ -140,7 +140,7 @@ A Snowflake function - + @@ -155,7 +155,7 @@ A Snowflake function - +
stringFunction's body.Function's body.
stringFunction's language.Function's language.
stringFunction's arguments.Function's arguments.
@@ -231,7 +231,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases. + Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases. @@ -251,17 +251,17 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database. + Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database. string - Query parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource. + Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource. boolean - Query parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist. + Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist. diff --git a/website/docs/function/index.md b/website/docs/services/function/index.md similarity index 91% rename from website/docs/function/index.md rename to website/docs/services/function/index.md index 3618fac..586a381 100644 --- a/website/docs/function/index.md +++ b/website/docs/services/function/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/grant/grant_options/index.md b/website/docs/services/grant/grant_options/index.md similarity index 95% rename from website/docs/grant/grant_options/index.md rename to website/docs/services/grant/grant_options/index.md index beb585b..822d8bd 100644 --- a/website/docs/grant/grant_options/index.md +++ b/website/docs/services/grant/grant_options/index.md @@ -127,12 +127,12 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - String that specifies the plural of the type of resource that is being secured by an ALL/FUTURE privilege. Must be either "schemas" or any plural object type that can nest under a schema such as "tables" + String that specifies the plural of the type of resource that is being secured by an ALL/FUTURE privilege. Must be either "schemas" or any plural object type that can nest under a schema such as "tables" string - If "cascade", recursively revoke the grant from sub-grantees to which this privilege was re-granted. Acceptable values are "restrict" or "cascade". + If "cascade", recursively revoke the grant from sub-grantees to which this privilege was re-granted. Acceptable values are "restrict" or "cascade". diff --git a/website/docs/grant/grants_to/index.md b/website/docs/services/grant/grants_to/index.md similarity index 98% rename from website/docs/grant/grants_to/index.md rename to website/docs/services/grant/grants_to/index.md index 21a1933..500ce8f 100644 --- a/website/docs/grant/grants_to/index.md +++ b/website/docs/services/grant/grants_to/index.md @@ -39,7 +39,7 @@ The following fields are returned by `SELECT` queries: > -Properties of a grant that can be granted to a role or user. +successful diff --git a/website/docs/grant/index.md b/website/docs/services/grant/index.md similarity index 76% rename from website/docs/grant/index.md rename to website/docs/services/grant/index.md index 15e588a..44432f6 100644 --- a/website/docs/grant/index.md +++ b/website/docs/services/grant/index.md @@ -25,10 +25,10 @@ total resources: __3__ ## Resources \ No newline at end of file diff --git a/website/docs/grant/privileges/index.md b/website/docs/services/grant/privileges/index.md similarity index 97% rename from website/docs/grant/privileges/index.md rename to website/docs/services/grant/privileges/index.md index ec54365..9fc9600 100644 --- a/website/docs/grant/privileges/index.md +++ b/website/docs/services/grant/privileges/index.md @@ -141,12 +141,12 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + - +
stringString that specifies the plural of the type of resource that is being secured by an ALL/FUTURE privilege. Must be either "schemas" or any plural object type that can nest under a schema such as "tables"String that specifies the plural of the type of resource that is being secured by an ALL/FUTURE privilege. Must be either "schemas" or any plural object type that can nest under a schema such as "tables"
stringIf "cascade", recursively revoke the grant from sub-grantees to which this privilege was re-granted. Acceptable values are "restrict" or "cascade".If "cascade", recursively revoke the grant from sub-grantees to which this privilege was re-granted. Acceptable values are "restrict" or "cascade".
diff --git a/website/docs/iceberg_table/iceberg_tables/index.md b/website/docs/services/iceberg_table/iceberg_tables/index.md similarity index 95% rename from website/docs/iceberg_table/iceberg_tables/index.md rename to website/docs/services/iceberg_table/iceberg_tables/index.md index f610d64..aab8f2b 100644 --- a/website/docs/iceberg_table/iceberg_tables/index.md +++ b/website/docs/services/iceberg_table/iceberg_tables/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake iceberg table +successful @@ -54,7 +54,7 @@ A Snowflake iceberg table - + @@ -64,12 +64,12 @@ A Snowflake iceberg table - + - + @@ -159,12 +159,12 @@ A Snowflake iceberg table - + - + @@ -181,7 +181,7 @@ A Snowflake iceberg table -A Snowflake iceberg table +successful
stringName of the iceberg table (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the iceberg table (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringDatabase in which the iceberg table is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Database in which the iceberg table is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringSchema in which the iceberg table is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Schema in which the iceberg table is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringRole that owns the iceberg table (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Role that owns the iceberg table (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe type of role that owns the iceberg table (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The type of role that owns the iceberg table (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
@@ -195,7 +195,7 @@ A Snowflake iceberg table - + @@ -205,12 +205,12 @@ A Snowflake iceberg table - + - + @@ -300,12 +300,12 @@ A Snowflake iceberg table - + - + @@ -468,7 +468,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -488,7 +488,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -498,7 +498,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -513,7 +513,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + diff --git a/website/docs/iceberg_table/index.md b/website/docs/services/iceberg_table/index.md similarity index 89% rename from website/docs/iceberg_table/index.md rename to website/docs/services/iceberg_table/index.md index a460e35..20d0a29 100644 --- a/website/docs/iceberg_table/index.md +++ b/website/docs/services/iceberg_table/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/image_repository/image_repositories/index.md b/website/docs/services/image_repository/image_repositories/index.md similarity index 81% rename from website/docs/image_repository/image_repositories/index.md rename to website/docs/services/image_repository/image_repositories/index.md index cbcb4dc..fdc0ee1 100644 --- a/website/docs/image_repository/image_repositories/index.md +++ b/website/docs/services/image_repository/image_repositories/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake image repository. +Successful request.
stringName of the iceberg table (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the iceberg table (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringDatabase in which the iceberg table is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Database in which the iceberg table is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringSchema in which the iceberg table is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Schema in which the iceberg table is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringRole that owns the iceberg table (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Role that owns the iceberg table (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe type of role that owns the iceberg table (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The type of role that owns the iceberg table (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -54,17 +54,17 @@ A Snowflake image repository. - + - + - + @@ -91,7 +91,7 @@ A Snowflake image repository. -A Snowflake image repository. +Successful request.
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
@@ -105,17 +105,17 @@ A Snowflake image repository. - + - + - + @@ -176,14 +176,14 @@ The following methods are available for this resource: - + - +
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
database_name, schema_name, endpoint createModeCreates an image repository in the specified database, schema, and create mode. The createMode query parameter specifies what action to take based on whether the repository already exists. See the ImageRepository component definition for what is required to be provided in the request body.Creates an image repository in the specified database, schema, and create mode. The `createMode` query parameter specifies what action to take based on whether the repository already exists. See the ImageRepository component definition for what is required to be provided in the request body.
database_name, schema_name, name, endpoint ifExistsDeletes an image repository with the given name. If you enable the ifExists query parameter, the operation succeeds even if the object does not exist. Otherwise, a 404 failure is returned if the object does not exist.Deletes an image repository with the given name. If you enable the `ifExists` query parameter, the operation succeeds even if the object does not exist. Otherwise, a 404 failure is returned if the object does not exist.
@@ -204,7 +204,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases. + Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases. @@ -219,17 +219,17 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database. + Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database. string - Query parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource. + Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource. boolean - Query parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist. + Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist. @@ -307,8 +307,6 @@ Creates an image repository in the specified database, schema, and create mode. ```sql INSERT INTO snowflake.image_repository.image_repositories ( data__name, -data__database_name, -data__schema_name, database_name, schema_name, endpoint, @@ -318,8 +316,6 @@ SELECT '{{ name }}' --required, '{{ database_name }}', '{{ schema_name }}', -'{{ database_name }}', -'{{ schema_name }}', '{{ endpoint }}', '{{ createMode }}' ; @@ -345,16 +341,6 @@ SELECT 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: database_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. - - - name: schema_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. - - name: createMode value: string description: Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource. diff --git a/website/docs/image_repository/images/index.md b/website/docs/services/image_repository/images/index.md similarity index 92% rename from website/docs/image_repository/images/index.md rename to website/docs/services/image_repository/images/index.md index 62d8c0a..106bf64 100644 --- a/website/docs/image_repository/images/index.md +++ b/website/docs/services/image_repository/images/index.md @@ -39,7 +39,7 @@ The following fields are returned by `SELECT` queries: > -A image in a Snowflake image repository. +Successful request. @@ -121,7 +121,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -136,7 +136,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - +
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
diff --git a/website/docs/image_repository/index.md b/website/docs/services/image_repository/index.md similarity index 80% rename from website/docs/image_repository/index.md rename to website/docs/services/image_repository/index.md index 2c93c02..6531508 100644 --- a/website/docs/image_repository/index.md +++ b/website/docs/services/image_repository/index.md @@ -25,9 +25,9 @@ total resources: __2__ ## Resources \ No newline at end of file diff --git a/website/docs/managed_account/index.md b/website/docs/services/managed_account/index.md similarity index 88% rename from website/docs/managed_account/index.md rename to website/docs/services/managed_account/index.md index 28a11d5..5f34fcb 100644 --- a/website/docs/managed_account/index.md +++ b/website/docs/services/managed_account/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/managed_account/managed_accounts/index.md b/website/docs/services/managed_account/managed_accounts/index.md similarity index 93% rename from website/docs/managed_account/managed_accounts/index.md rename to website/docs/services/managed_account/managed_accounts/index.md index cbbd88c..fe23d4c 100644 --- a/website/docs/managed_account/managed_accounts/index.md +++ b/website/docs/services/managed_account/managed_accounts/index.md @@ -39,7 +39,7 @@ The following fields are returned by `SELECT` queries: > -Snowflake account object. +Successful request. @@ -53,7 +53,7 @@ Snowflake account object. - + @@ -257,7 +257,7 @@ SELECT - 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. + Name of the account. - name: comment value: string diff --git a/website/docs/network_policy/index.md b/website/docs/services/network_policy/index.md similarity index 88% rename from website/docs/network_policy/index.md rename to website/docs/services/network_policy/index.md index 0c52494..9c119a5 100644 --- a/website/docs/network_policy/index.md +++ b/website/docs/services/network_policy/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/network_policy/network_policies/index.md b/website/docs/services/network_policy/network_policies/index.md similarity index 88% rename from website/docs/network_policy/network_policies/index.md rename to website/docs/services/network_policy/network_policies/index.md index 41ae1a1..c41db7c 100644 --- a/website/docs/network_policy/network_policies/index.md +++ b/website/docs/services/network_policy/network_policies/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake network policy +successful
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)Name of the account. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
@@ -54,7 +54,7 @@ A Snowflake network policy - + @@ -89,19 +89,19 @@ A Snowflake network policy - + - +
stringName of the network policy (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the network policy (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringRole that owns the network policy (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Role that owns the network policy (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe type of role that owns the network policy (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The type of role that owns the network policy (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
-A Snowflake network policy +successful @@ -115,7 +115,7 @@ A Snowflake network policy - + @@ -150,12 +150,12 @@ A Snowflake network policy - + - +
stringName of the network policy (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the network policy (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringRole that owns the network policy (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Role that owns the network policy (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe type of role that owns the network policy (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The type of role that owns the network policy (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
@@ -234,12 +234,12 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Query parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource. + Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource. boolean - Query parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist. + Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist. diff --git a/website/docs/notebook/index.md b/website/docs/services/notebook/index.md similarity index 91% rename from website/docs/notebook/index.md rename to website/docs/services/notebook/index.md index 43c9bbb..238d9b2 100644 --- a/website/docs/notebook/index.md +++ b/website/docs/services/notebook/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/notebook/notebooks/index.md b/website/docs/services/notebook/notebooks/index.md similarity index 89% rename from website/docs/notebook/notebooks/index.md rename to website/docs/services/notebook/notebooks/index.md index 461faa6..4c90c8a 100644 --- a/website/docs/notebook/notebooks/index.md +++ b/website/docs/services/notebook/notebooks/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake notebook +successful @@ -54,7 +54,7 @@ A Snowflake notebook - + @@ -64,7 +64,7 @@ A Snowflake notebook - + @@ -74,12 +74,12 @@ A Snowflake notebook - + - + @@ -154,12 +154,12 @@ A Snowflake notebook - + - + @@ -186,7 +186,7 @@ A Snowflake notebook -A Snowflake notebook +successful
stringName of the notebook (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the notebook (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringDatabase in which the notebook is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Database in which the notebook is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringSchema in which the notebook is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Schema in which the notebook is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringName of the budget if the notebook is monitored by a budget (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the budget if the notebook is monitored by a budget (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringRole that owns the notebook (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Role that owns the notebook (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe type of role that owns the notebook (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The type of role that owns the notebook (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
@@ -200,7 +200,7 @@ A Snowflake notebook - + @@ -210,7 +210,7 @@ A Snowflake notebook - + @@ -220,12 +220,12 @@ A Snowflake notebook - + - + @@ -300,12 +300,12 @@ A Snowflake notebook - + - + @@ -422,7 +422,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -437,7 +437,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -457,7 +457,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -472,7 +472,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -622,8 +622,6 @@ data__main_file, data__comment, data__default_version, data__query_warehouse, -data__default_version_details, -data__last_version_details, database_name, schema_name, endpoint, @@ -637,8 +635,6 @@ SELECT '{{ comment }}', '{{ default_version }}', '{{ query_warehouse }}', -'{{ default_version_details }}', -'{{ last_version_details }}', '{{ database_name }}', '{{ schema_name }}', '{{ endpoint }}', @@ -696,16 +692,6 @@ SELECT description: > Warehouse against which the queries issued by the Streamlit app are run against - - name: default_version_details - value: object - description: > - The version details of a file based entity - - - name: last_version_details - value: object - description: > - The version details of a file based entity - - name: createMode value: string description: Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource. diff --git a/website/docs/notification_integration/index.md b/website/docs/services/notification_integration/index.md similarity index 85% rename from website/docs/notification_integration/index.md rename to website/docs/services/notification_integration/index.md index be04f50..76109c0 100644 --- a/website/docs/notification_integration/index.md +++ b/website/docs/services/notification_integration/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/notification_integration/notification_integrations/index.md b/website/docs/services/notification_integration/notification_integrations/index.md similarity index 90% rename from website/docs/notification_integration/notification_integrations/index.md rename to website/docs/services/notification_integration/notification_integrations/index.md index c9ed370..ff86264 100644 --- a/website/docs/notification_integration/notification_integrations/index.md +++ b/website/docs/services/notification_integration/notification_integrations/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake notification +successful
stringName of the notebook (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the notebook (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringDatabase in which the notebook is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Database in which the notebook is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringSchema in which the notebook is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Schema in which the notebook is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringName of the budget if the notebook is monitored by a budget (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the budget if the notebook is monitored by a budget (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringRole that owns the notebook (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Role that owns the notebook (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe type of role that owns the notebook (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The type of role that owns the notebook (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -54,7 +54,7 @@ A Snowflake notification - + @@ -81,7 +81,7 @@ A Snowflake notification -A Snowflake notification +successful
stringName of the notification. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the notification. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
@@ -95,7 +95,7 @@ A Snowflake notification - + @@ -194,12 +194,12 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + - + diff --git a/website/docs/pipe/index.md b/website/docs/services/pipe/index.md similarity index 92% rename from website/docs/pipe/index.md rename to website/docs/services/pipe/index.md index 35ba14d..7e7c009 100644 --- a/website/docs/pipe/index.md +++ b/website/docs/services/pipe/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/pipe/pipes/index.md b/website/docs/services/pipe/pipes/index.md similarity index 94% rename from website/docs/pipe/pipes/index.md rename to website/docs/services/pipe/pipes/index.md index 9a1cbea..e88a3eb 100644 --- a/website/docs/pipe/pipes/index.md +++ b/website/docs/services/pipe/pipes/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake pipe +successful
stringName of the notification. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the notification. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -131,7 +131,7 @@ A Snowflake pipe -A Snowflake pipe +successful
@@ -291,7 +291,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -306,17 +306,17 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + - + - + diff --git a/website/docs/procedure/index.md b/website/docs/services/procedure/index.md similarity index 90% rename from website/docs/procedure/index.md rename to website/docs/services/procedure/index.md index 8eb8b01..b9e7f7a 100644 --- a/website/docs/procedure/index.md +++ b/website/docs/services/procedure/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/procedure/procedures/index.md b/website/docs/services/procedure/procedures/index.md similarity index 89% rename from website/docs/procedure/procedures/index.md rename to website/docs/services/procedure/procedures/index.md index aee3ca9..bf25980 100644 --- a/website/docs/procedure/procedures/index.md +++ b/website/docs/services/procedure/procedures/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake procedure +successful
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -54,17 +54,17 @@ A Snowflake procedure - + - + - + @@ -104,7 +104,7 @@ A Snowflake procedure - + @@ -129,14 +129,14 @@ A Snowflake procedure - +
stringName of the procedure (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the procedure (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe name of the database in which the function/procedure exists. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The name of the database in which the function/procedure exists. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe name of the schema in which the function/procedure exists. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The name of the schema in which the function/procedure exists. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
objectLanguage that the function/procedure is written in
objectReturn type of the function/procedure. Should be a SQL data type or a table
-A Snowflake procedure +successful @@ -150,17 +150,17 @@ A Snowflake procedure - + - + - + @@ -200,7 +200,7 @@ A Snowflake procedure - + @@ -225,7 +225,7 @@ A Snowflake procedure - +
stringName of the procedure (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the procedure (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe name of the database in which the function/procedure exists. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The name of the database in which the function/procedure exists. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe name of the schema in which the function/procedure exists. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The name of the schema in which the function/procedure exists. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
objectLanguage that the function/procedure is written in
objectReturn type of the function/procedure. Should be a SQL data type or a table
@@ -301,7 +301,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases. + Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases. @@ -316,7 +316,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database. + Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database. @@ -326,12 +326,12 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Query parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource. + Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource. boolean - Query parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist. + Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist. @@ -495,8 +495,14 @@ SELECT - name: return_type value: object + description: > + Return type of the function/procedure. Should be a SQL data type or a table + - name: language_config value: object + description: > + Language that the function/procedure is written in + - name: comment value: string description: > diff --git a/website/docs/result/index.md b/website/docs/services/result/index.md similarity index 91% rename from website/docs/result/index.md rename to website/docs/services/result/index.md index 1067504..df42e4a 100644 --- a/website/docs/result/index.md +++ b/website/docs/services/result/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/result/results/index.md b/website/docs/services/result/results/index.md similarity index 100% rename from website/docs/result/results/index.md rename to website/docs/services/result/results/index.md diff --git a/website/docs/role/future_grants/index.md b/website/docs/services/role/future_grants/index.md similarity index 97% rename from website/docs/role/future_grants/index.md rename to website/docs/services/role/future_grants/index.md index d742a9c..a5f130c 100644 --- a/website/docs/role/future_grants/index.md +++ b/website/docs/services/role/future_grants/index.md @@ -53,7 +53,7 @@ successful object - + Containing scope of the grant @@ -78,7 +78,7 @@ successful object - + Securable of the grant @@ -243,8 +243,14 @@ SELECT description: Required parameter for the future_grants resource. - name: securable value: object + description: > + Securable of the grant + - name: containing_scope value: object + description: > + Containing scope of the grant + - name: securable_type value: string description: > diff --git a/website/docs/role/grants/index.md b/website/docs/services/role/grants/index.md similarity index 97% rename from website/docs/role/grants/index.md rename to website/docs/services/role/grants/index.md index 57094fd..ca16211 100644 --- a/website/docs/role/grants/index.md +++ b/website/docs/services/role/grants/index.md @@ -53,7 +53,7 @@ successful object - + Containing scope of the grant @@ -78,7 +78,7 @@ successful object - + Securable of the grant @@ -243,8 +243,14 @@ SELECT description: Required parameter for the grants resource. - name: securable value: object + description: > + Securable of the grant + - name: containing_scope value: object + description: > + Containing scope of the grant + - name: securable_type value: string description: > diff --git a/website/docs/role/grants_of/index.md b/website/docs/services/role/grants_of/index.md similarity index 100% rename from website/docs/role/grants_of/index.md rename to website/docs/services/role/grants_of/index.md diff --git a/website/docs/role/grants_on/index.md b/website/docs/services/role/grants_on/index.md similarity index 100% rename from website/docs/role/grants_on/index.md rename to website/docs/services/role/grants_on/index.md diff --git a/website/docs/role/index.md b/website/docs/services/role/index.md similarity index 67% rename from website/docs/role/index.md rename to website/docs/services/role/index.md index bd27c88..ff8da21 100644 --- a/website/docs/role/index.md +++ b/website/docs/services/role/index.md @@ -25,12 +25,12 @@ total resources: __5__ ## Resources \ No newline at end of file diff --git a/website/docs/role/roles/index.md b/website/docs/services/role/roles/index.md similarity index 88% rename from website/docs/role/roles/index.md rename to website/docs/services/role/roles/index.md index c751b12..3a1534c 100644 --- a/website/docs/role/roles/index.md +++ b/website/docs/services/role/roles/index.md @@ -39,7 +39,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake role +successful @@ -53,7 +53,7 @@ A Snowflake role - + @@ -83,12 +83,12 @@ A Snowflake role - + - + @@ -98,7 +98,7 @@ A Snowflake role - +
stringName of the role. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the role. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
booleanSpecifies whether the role being fetched is the user's current role.Specifies whether the role being fetched is the user's current role.
booleanSpecifies whether the role being fetched is the user's default role.Specifies whether the role being fetched is the user's default role.
stringSpecifies the role that owns this role. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Specifies the role that owns this role. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
@@ -170,7 +170,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Query parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource. + Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource. @@ -180,7 +180,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# boolean - Query parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist. + Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist. diff --git a/website/docs/schema/index.md b/website/docs/services/schema/index.md similarity index 91% rename from website/docs/schema/index.md rename to website/docs/services/schema/index.md index a84b8c1..c5f0b49 100644 --- a/website/docs/schema/index.md +++ b/website/docs/services/schema/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/schema/schemas/index.md b/website/docs/services/schema/schemas/index.md similarity index 92% rename from website/docs/schema/schemas/index.md rename to website/docs/services/schema/schemas/index.md index 0d3a34e..5be3fd2 100644 --- a/website/docs/schema/schemas/index.md +++ b/website/docs/services/schema/schemas/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -Snowflake schema definition. +Successful request. @@ -54,7 +54,7 @@ Snowflake schema definition. - + @@ -181,7 +181,7 @@ Snowflake schema definition. -Snowflake schema definition. +successful
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)Name of the schema. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
@@ -195,7 +195,7 @@ Snowflake schema definition. - + @@ -370,7 +370,7 @@ The following methods are available for this resource: - + @@ -405,7 +405,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -420,7 +420,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -430,17 +430,17 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + - + - + @@ -450,7 +450,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -633,7 +633,7 @@ SELECT - 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. + Name of the schema. - name: kind value: string diff --git a/website/docs/service/containers/index.md b/website/docs/services/service/containers/index.md similarity index 81% rename from website/docs/service/containers/index.md rename to website/docs/services/service/containers/index.md index 83ffc33..b757b2a 100644 --- a/website/docs/service/containers/index.md +++ b/website/docs/services/service/containers/index.md @@ -63,7 +63,7 @@ successful - + @@ -73,12 +73,12 @@ successful - + - + @@ -161,7 +161,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -176,7 +176,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - +
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)Name of the schema. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
database_name, name, endpoint ifExists, restrictDeletes the specified schema. If you enable the ifExists parameter, the operation succeeds even if the schema does not exist. Otherwise, a 404 failure is returned if the schema does not exist. if the drop is unsuccessful.Deletes the specified schema. If you enable the `ifExists` parameter, the operation succeeds even if the schema does not exist. Otherwise, a 404 failure is returned if the schema does not exist. if the drop is unsuccessful.
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanWhether to include dropped schemas that have not yet been purged. Default: false.Whether to include dropped schemas that have not yet been purged. Default: `false`.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
stringType of schema to clone. Currently, Snowflake supports only transient and permanent (also represented by the empty string).Type of schema to clone. Currently, Snowflake supports only `transient` and `permanent` (also represented by the empty string).
booleanWhether to drop the schema if foreign keys exist that reference any tables in the schema. - true: Return a warning about existing foreign key references and don't drop the schema. - false: Drop the schema and all objects in the database, including tables with primary or unique keys that are referenced by foreign keys in other tables. Default: false.Whether to drop the schema if foreign keys exist that reference any tables in the schema. - `true`: Return a warning about existing foreign key references and don't drop the schema. - `false`: Drop the schema and all objects in the database, including tables with primary or unique keys that are referenced by foreign keys in other tables. Default: `false`.
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)Database in which the service is created. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)Schema in which the service is created. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)The name of the service. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
diff --git a/website/docs/service/endpoints/index.md b/website/docs/services/service/endpoints/index.md similarity index 94% rename from website/docs/service/endpoints/index.md rename to website/docs/services/service/endpoints/index.md index c9caded..38bdd7a 100644 --- a/website/docs/service/endpoints/index.md +++ b/website/docs/services/service/endpoints/index.md @@ -126,7 +126,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases. + Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases. @@ -141,7 +141,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database. + Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database. diff --git a/website/docs/service/grants/index.md b/website/docs/services/service/grants/index.md similarity index 94% rename from website/docs/service/grants/index.md rename to website/docs/services/service/grants/index.md index 3c39cc5..05cb37b 100644 --- a/website/docs/service/grants/index.md +++ b/website/docs/services/service/grants/index.md @@ -126,7 +126,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases. + Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases. @@ -141,7 +141,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database. + Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database. diff --git a/website/docs/service/grants_of/index.md b/website/docs/services/service/grants_of/index.md similarity index 94% rename from website/docs/service/grants_of/index.md rename to website/docs/services/service/grants_of/index.md index a86efff..a003afb 100644 --- a/website/docs/service/grants_of/index.md +++ b/website/docs/services/service/grants_of/index.md @@ -121,7 +121,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases. + Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases. @@ -136,7 +136,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database. + Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database. diff --git a/website/docs/service/index.md b/website/docs/services/service/index.md similarity index 52% rename from website/docs/service/index.md rename to website/docs/services/service/index.md index 8b3cbd6..794d6c2 100644 --- a/website/docs/service/index.md +++ b/website/docs/services/service/index.md @@ -25,16 +25,16 @@ total resources: __9__ ## Resources \ No newline at end of file diff --git a/website/docs/service/instances/index.md b/website/docs/services/service/instances/index.md similarity index 80% rename from website/docs/service/instances/index.md rename to website/docs/services/service/instances/index.md index d86fe83..9d5bc44 100644 --- a/website/docs/service/instances/index.md +++ b/website/docs/services/service/instances/index.md @@ -58,17 +58,17 @@ successful string - 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME) + Database in which the service is created. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME) string - 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME) + Schema in which the service is created. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME) string - 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME) + The name of the service. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME) @@ -141,7 +141,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases. + Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases. @@ -156,7 +156,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database. + Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database. diff --git a/website/docs/service/logs/index.md b/website/docs/services/service/logs/index.md similarity index 93% rename from website/docs/service/logs/index.md rename to website/docs/services/service/logs/index.md index aa14b12..21c4493 100644 --- a/website/docs/service/logs/index.md +++ b/website/docs/services/service/logs/index.md @@ -106,7 +106,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases. + Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases. @@ -126,7 +126,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database. + Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database. diff --git a/website/docs/service/roles/index.md b/website/docs/services/service/roles/index.md similarity index 93% rename from website/docs/service/roles/index.md rename to website/docs/services/service/roles/index.md index 9745be6..d78db61 100644 --- a/website/docs/service/roles/index.md +++ b/website/docs/services/service/roles/index.md @@ -111,7 +111,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases. + Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases. @@ -126,7 +126,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database. + Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database. diff --git a/website/docs/service/services/index.md b/website/docs/services/service/services/index.md similarity index 85% rename from website/docs/service/services/index.md rename to website/docs/services/service/services/index.md index e7b4048..fafd93c 100644 --- a/website/docs/service/services/index.md +++ b/website/docs/services/service/services/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake service object. +successful @@ -54,12 +54,12 @@ A Snowflake service object. - + - + @@ -74,7 +74,7 @@ A Snowflake service object. - + @@ -159,7 +159,7 @@ A Snowflake service object. - + @@ -201,7 +201,7 @@ A Snowflake service object. -A Snowflake service object. +successful
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)String that specifies the identifier (that is, the name) for the service. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)The name of the parent database for the service. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)The name of the parent schema for the service. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)Warehouse to use if a service container connects to Snowflake to execute a query but does not explicitly specify a warehouse to use. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
@@ -215,12 +215,12 @@ A Snowflake service object. - + - + @@ -235,7 +235,7 @@ A Snowflake service object. - + @@ -320,7 +320,7 @@ A Snowflake service object. - + @@ -452,7 +452,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -467,12 +467,12 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + - + @@ -482,7 +482,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -628,8 +628,6 @@ data__auto_resume, data__min_ready_instances, data__min_instances, data__max_instances, -data__database_name, -data__schema_name, data__auto_suspend_secs, database_name, schema_name, @@ -649,8 +647,6 @@ SELECT {{ min_ready_instances }}, {{ min_instances }}, {{ max_instances }}, -'{{ database_name }}', -'{{ schema_name }}', {{ auto_suspend_secs }}, '{{ database_name }}', '{{ schema_name }}', @@ -677,7 +673,7 @@ SELECT - 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. + String that specifies the identifier (that is, the name) for the service. - name: status value: string @@ -702,7 +698,7 @@ SELECT - name: query_warehouse 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. + Warehouse to use if a service container connects to Snowflake to execute a query but does not explicitly specify a warehouse to use. - name: comment value: string @@ -734,16 +730,6 @@ SELECT description: > Specifies the maximum number of service instances to run. - - name: database_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. - - - name: schema_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. - - name: auto_suspend_secs value: integer description: > @@ -784,8 +770,6 @@ data__auto_resume = {{ auto_resume }}, data__min_ready_instances = {{ min_ready_instances }}, data__min_instances = {{ min_instances }}, data__max_instances = {{ max_instances }}, -data__database_name = '{{ database_name }}', -data__schema_name = '{{ schema_name }}', data__auto_suspend_secs = {{ auto_suspend_secs }} WHERE database_name = '{{ database_name }}' --required diff --git a/website/docs/service/status/index.md b/website/docs/services/service/status/index.md similarity index 93% rename from website/docs/service/status/index.md rename to website/docs/services/service/status/index.md index 31b03ab..526794d 100644 --- a/website/docs/service/status/index.md +++ b/website/docs/services/service/status/index.md @@ -101,7 +101,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -116,7 +116,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + diff --git a/website/docs/sqlapi/index.md b/website/docs/services/sqlapi/index.md similarity index 90% rename from website/docs/sqlapi/index.md rename to website/docs/services/sqlapi/index.md index 33593bc..f9fb05d 100644 --- a/website/docs/sqlapi/index.md +++ b/website/docs/services/sqlapi/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/sqlapi/statements/index.md b/website/docs/services/sqlapi/statements/index.md similarity index 100% rename from website/docs/sqlapi/statements/index.md rename to website/docs/services/sqlapi/statements/index.md diff --git a/website/docs/stage/index.md b/website/docs/services/stage/index.md similarity index 76% rename from website/docs/stage/index.md rename to website/docs/services/stage/index.md index 66bb14f..4bf0b01 100644 --- a/website/docs/stage/index.md +++ b/website/docs/services/stage/index.md @@ -25,10 +25,10 @@ total resources: __3__ ## Resources \ No newline at end of file diff --git a/website/docs/stage/presigned_url/index.md b/website/docs/services/stage/presigned_url/index.md similarity index 92% rename from website/docs/stage/presigned_url/index.md rename to website/docs/services/stage/presigned_url/index.md index c150404..1c2c8a4 100644 --- a/website/docs/stage/presigned_url/index.md +++ b/website/docs/services/stage/presigned_url/index.md @@ -39,7 +39,7 @@ The following fields are returned by `SELECT` queries: > -Materials for uploading and downloading stage files +successful
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)String that specifies the identifier (that is, the name) for the service. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)The name of the parent database for the service. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)The name of the parent schema for the service. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)Warehouse to use if a service container connects to Snowflake to execute a query but does not explicitly specify a warehouse to use. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
@@ -101,7 +101,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -121,7 +121,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - +
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
diff --git a/website/docs/stage/stage_files/index.md b/website/docs/services/stage/stage_files/index.md similarity index 93% rename from website/docs/stage/stage_files/index.md rename to website/docs/services/stage/stage_files/index.md index 18cc0c8..26c5c83 100644 --- a/website/docs/stage/stage_files/index.md +++ b/website/docs/services/stage/stage_files/index.md @@ -39,7 +39,7 @@ The following fields are returned by `SELECT` queries: > -A file on a snowflake stage. +successful @@ -116,7 +116,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -131,7 +131,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + diff --git a/website/docs/stage/stages/index.md b/website/docs/services/stage/stages/index.md similarity index 84% rename from website/docs/stage/stages/index.md rename to website/docs/services/stage/stages/index.md index 184239c..f9264b6 100644 --- a/website/docs/stage/stages/index.md +++ b/website/docs/services/stage/stages/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake stage. +successful
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
@@ -54,7 +54,7 @@ A Snowflake stage. - + @@ -74,7 +74,7 @@ A Snowflake stage. - + @@ -124,7 +124,7 @@ A Snowflake stage. - + @@ -136,7 +136,7 @@ A Snowflake stage. -A Snowflake stage. +successful
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)String that specifies the identifier (i.e. name) for the stage. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
objectSpecifies the credentials of the stage.Credentials of the stage.
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)Storage integration associated with the stage; always NULL for an internal stage. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
@@ -150,7 +150,7 @@ A Snowflake stage. - + @@ -170,7 +170,7 @@ A Snowflake stage. - + @@ -220,7 +220,7 @@ A Snowflake stage. - + @@ -294,7 +294,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -309,17 +309,17 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + - + - + @@ -463,7 +463,7 @@ SELECT - 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. + String that specifies the identifier (i.e. name) for the stage. - name: kind value: string @@ -485,7 +485,7 @@ SELECT - name: storage_integration 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. + Storage integration associated with the stage; always NULL for an internal stage. - name: comment value: string @@ -495,7 +495,7 @@ SELECT - name: credentials value: object description: > - Specifies the credentials of the stage. + Credentials of the stage. - name: encryption value: object diff --git a/website/docs/streams/index.md b/website/docs/services/streams/index.md similarity index 91% rename from website/docs/streams/index.md rename to website/docs/services/streams/index.md index 2b86046..8e49649 100644 --- a/website/docs/streams/index.md +++ b/website/docs/services/streams/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/streams/streams/index.md b/website/docs/services/streams/streams/index.md similarity index 86% rename from website/docs/streams/streams/index.md rename to website/docs/services/streams/streams/index.md index 2d0e95a..710e081 100644 --- a/website/docs/streams/streams/index.md +++ b/website/docs/services/streams/streams/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake stream +successful
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)String that specifies the identifier (i.e. name) for the stage. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
objectSpecifies the credentials of the stage.Credentials of the stage.
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)Storage integration associated with the stage; always NULL for an internal stage. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -54,22 +54,22 @@ A Snowflake stream - + - + - + - + @@ -94,12 +94,12 @@ A Snowflake stream - + - + @@ -114,7 +114,7 @@ A Snowflake stream - + @@ -126,7 +126,7 @@ A Snowflake stream -A Snowflake stream +successful
stringName of the stream (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the stream (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringDatabase in which the stream is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Database in which the stream is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringSchema in which the stream is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Schema in which the stream is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringTable name whose changes are tracked by the stream (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Table name whose changes are tracked by the stream (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringRole that owns the stream (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Role that owns the stream (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe type of role that owns the stream (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The type of role that owns the stream (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
objectSource for the stream
@@ -140,22 +140,22 @@ A Snowflake stream - + - + - + - + @@ -180,12 +180,12 @@ A Snowflake stream - + - + @@ -200,7 +200,7 @@ A Snowflake stream - + @@ -281,7 +281,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -296,7 +296,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -316,7 +316,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -326,7 +326,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -473,6 +473,9 @@ SELECT - name: stream_source value: object + description: > + Source for the stream + - name: comment value: string description: > diff --git a/website/docs/table/index.md b/website/docs/services/table/index.md similarity index 92% rename from website/docs/table/index.md rename to website/docs/services/table/index.md index fc65edf..0a92852 100644 --- a/website/docs/table/index.md +++ b/website/docs/services/table/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/table/tables/index.md b/website/docs/services/table/tables/index.md similarity index 97% rename from website/docs/table/tables/index.md rename to website/docs/services/table/tables/index.md index 84a71e2..013eeb9 100644 --- a/website/docs/table/tables/index.md +++ b/website/docs/services/table/tables/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake table +successful
stringName of the stream (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Name of the stream (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringDatabase in which the stream is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Database in which the stream is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringSchema in which the stream is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Schema in which the stream is stored (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringTable name whose changes are tracked by the stream (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Table name whose changes are tracked by the stream (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringRole that owns the stream (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Role that owns the stream (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe type of role that owns the stream (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The type of role that owns the stream (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
objectSource for the stream
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -181,7 +181,7 @@ A Snowflake table -A Snowflake table +successful
@@ -489,7 +489,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -514,7 +514,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -534,7 +534,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -554,7 +554,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + diff --git a/website/docs/task/complete_graphs/index.md b/website/docs/services/task/complete_graphs/index.md similarity index 95% rename from website/docs/task/complete_graphs/index.md rename to website/docs/services/task/complete_graphs/index.md index 4aa2788..1ddde56 100644 --- a/website/docs/task/complete_graphs/index.md +++ b/website/docs/services/task/complete_graphs/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A task run executing a standalone task or a DAG of tasks starting from the root task. +successful
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -126,7 +126,7 @@ A task run executing a standalone task or a DAG of tasks starting from the root -A task run executing a standalone task or a DAG of tasks starting from the root task. +successful
@@ -260,7 +260,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -275,7 +275,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + diff --git a/website/docs/task/current_graphs/index.md b/website/docs/services/task/current_graphs/index.md similarity index 95% rename from website/docs/task/current_graphs/index.md rename to website/docs/services/task/current_graphs/index.md index 30f531c..2877cc1 100644 --- a/website/docs/task/current_graphs/index.md +++ b/website/docs/services/task/current_graphs/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A task run executing a standalone task or a DAG of tasks starting from the root task. +successful
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
@@ -126,7 +126,7 @@ A task run executing a standalone task or a DAG of tasks starting from the root -A task run executing a standalone task or a DAG of tasks starting from the root task. +successful
@@ -260,7 +260,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -275,7 +275,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + diff --git a/website/docs/task/dependents/index.md b/website/docs/services/task/dependents/index.md similarity index 91% rename from website/docs/task/dependents/index.md rename to website/docs/services/task/dependents/index.md index f3deb56..83532c4 100644 --- a/website/docs/task/dependents/index.md +++ b/website/docs/services/task/dependents/index.md @@ -39,7 +39,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake task, used to execute SQL code. +successful
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
@@ -58,7 +58,7 @@ A Snowflake task, used to execute SQL code. - + @@ -193,7 +193,7 @@ A Snowflake task, used to execute SQL code. - +
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)String that specifies the identifier (i.e. name) for the task. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)Specifies the virtual warehouse that provides compute resources for task runs. Omit this parameter to use serverless compute resources for runs of this task. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
@@ -241,7 +241,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases. + Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases. @@ -256,7 +256,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database. + Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database. diff --git a/website/docs/task/index.md b/website/docs/services/task/index.md similarity index 70% rename from website/docs/task/index.md rename to website/docs/services/task/index.md index c1c110b..59b2eac 100644 --- a/website/docs/task/index.md +++ b/website/docs/services/task/index.md @@ -25,11 +25,11 @@ total resources: __4__ ## Resources \ No newline at end of file diff --git a/website/docs/task/tasks/index.md b/website/docs/services/task/tasks/index.md similarity index 92% rename from website/docs/task/tasks/index.md rename to website/docs/services/task/tasks/index.md index ca99db7..9f8556f 100644 --- a/website/docs/task/tasks/index.md +++ b/website/docs/services/task/tasks/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake task, used to execute SQL code. +successful @@ -59,7 +59,7 @@ A Snowflake task, used to execute SQL code. - + @@ -194,14 +194,14 @@ A Snowflake task, used to execute SQL code. - +
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)String that specifies the identifier (i.e. name) for the task. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)Specifies the virtual warehouse that provides compute resources for task runs. Omit this parameter to use serverless compute resources for runs of this task. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
-A Snowflake task, used to execute SQL code. +successful @@ -220,7 +220,7 @@ A Snowflake task, used to execute SQL code. - + @@ -355,7 +355,7 @@ A Snowflake task, used to execute SQL code. - +
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)String that specifies the identifier (i.e. name) for the task. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)Specifies the virtual warehouse that provides compute resources for task runs. Omit this parameter to use serverless compute resources for runs of this task. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
@@ -452,7 +452,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases. + Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases. @@ -467,7 +467,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Identifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database. + Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database. @@ -477,7 +477,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# string - Query parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource. + Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource. @@ -487,7 +487,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# boolean - Query parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist. + Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist. @@ -701,12 +701,12 @@ SELECT - 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. + String that specifies the identifier (i.e. name) for the task. - name: warehouse 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. + Specifies the virtual warehouse that provides compute resources for task runs. Omit this parameter to use serverless compute resources for runs of this task. - name: schedule value: object diff --git a/website/docs/user/grants/index.md b/website/docs/services/user/grants/index.md similarity index 96% rename from website/docs/user/grants/index.md rename to website/docs/services/user/grants/index.md index d9eb5b1..a832f0c 100644 --- a/website/docs/user/grants/index.md +++ b/website/docs/services/user/grants/index.md @@ -53,7 +53,7 @@ successful object - + Containing scope of the grant @@ -73,7 +73,7 @@ successful object - + Securable of the grant @@ -230,8 +230,14 @@ SELECT description: Required parameter for the grants resource. - name: securable value: object + description: > + Securable of the grant + - name: containing_scope value: object + description: > + Containing scope of the grant + - name: securable_type value: string description: > diff --git a/website/docs/user/index.md b/website/docs/services/user/index.md similarity index 86% rename from website/docs/user/index.md rename to website/docs/services/user/index.md index 4547b70..db72cd4 100644 --- a/website/docs/user/index.md +++ b/website/docs/services/user/index.md @@ -25,9 +25,9 @@ total resources: __2__ ## Resources \ No newline at end of file diff --git a/website/docs/user/users/index.md b/website/docs/services/user/users/index.md similarity index 96% rename from website/docs/user/users/index.md rename to website/docs/services/user/users/index.md index 06b2c91..f1adc81 100644 --- a/website/docs/user/users/index.md +++ b/website/docs/services/user/users/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -Properties of user. +successful @@ -229,12 +229,12 @@ Properties of user. - + - + @@ -256,7 +256,7 @@ Properties of user. -Properties of user. +successful
stringFingerprint of the user's second RSA public keyFingerprint of the user's second RSA public key
stringFingerprint of the user's RSA public keyFingerprint of the user's RSA public key
@@ -445,12 +445,12 @@ Properties of user. - + - + @@ -551,7 +551,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -561,7 +561,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + diff --git a/website/docs/user_defined_function/index.md b/website/docs/services/user_defined_function/index.md similarity index 86% rename from website/docs/user_defined_function/index.md rename to website/docs/services/user_defined_function/index.md index b4a3eab..701d16d 100644 --- a/website/docs/user_defined_function/index.md +++ b/website/docs/services/user_defined_function/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/user_defined_function/user_defined_functions/index.md b/website/docs/services/user_defined_function/user_defined_functions/index.md similarity index 89% rename from website/docs/user_defined_function/user_defined_functions/index.md rename to website/docs/services/user_defined_function/user_defined_functions/index.md index e9f8e96..3a46b55 100644 --- a/website/docs/user_defined_function/user_defined_functions/index.md +++ b/website/docs/services/user_defined_function/user_defined_functions/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A snowflake UDF +successful
stringFingerprint of the user's second RSA public keyFingerprint of the user's second RSA public key
stringFingerprint of the user's RSA public keyFingerprint of the user's RSA public key
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -54,17 +54,17 @@ A snowflake UDF - + - + - + @@ -119,7 +119,7 @@ A snowflake UDF - + @@ -134,17 +134,17 @@ A snowflake UDF - + - + - + @@ -156,7 +156,7 @@ A snowflake UDF -A snowflake UDF +successful
stringThe name of the UDF (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The name of the UDF (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe name of the database in which the function/procedure exists. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The name of the database in which the function/procedure exists. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe name of the schema in which the function/procedure exists. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The name of the schema in which the function/procedure exists. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
objectLanguage that the function/procedure is written in
stringRole that owns the function/procedure (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Role that owns the function/procedure (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe type of role that owns the function/procedure (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The type of role that owns the function/procedure (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
objectReturn type of the function/procedure. Should be a SQL data type or a table
@@ -170,17 +170,17 @@ A snowflake UDF - + - + - + @@ -235,7 +235,7 @@ A snowflake UDF - + @@ -250,17 +250,17 @@ A snowflake UDF - + - + - + @@ -341,7 +341,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -356,7 +356,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -381,12 +381,12 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + - + @@ -571,8 +571,14 @@ SELECT - name: return_type value: object + description: > + Return type of the function/procedure. Should be a SQL data type or a table + - name: language_config value: object + description: > + Language that the function/procedure is written in + - name: comment value: string description: > diff --git a/website/docs/view/index.md b/website/docs/services/view/index.md similarity index 92% rename from website/docs/view/index.md rename to website/docs/services/view/index.md index bee59ee..ed7ac02 100644 --- a/website/docs/view/index.md +++ b/website/docs/services/view/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/view/views/index.md b/website/docs/services/view/views/index.md similarity index 93% rename from website/docs/view/views/index.md rename to website/docs/services/view/views/index.md index 6412cb4..85d95a1 100644 --- a/website/docs/view/views/index.md +++ b/website/docs/services/view/views/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake view +successful
stringThe name of the UDF (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The name of the UDF (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe name of the database in which the function/procedure exists. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The name of the database in which the function/procedure exists. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe name of the schema in which the function/procedure exists. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The name of the schema in which the function/procedure exists. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
objectLanguage that the function/procedure is written in
stringRole that owns the function/procedure (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)Role that owns the function/procedure (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
stringThe type of role that owns the function/procedure (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)The type of role that owns the function/procedure (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$)
objectReturn type of the function/procedure. Should be a SQL data type or a table
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -116,7 +116,7 @@ A Snowflake view -A Snowflake view +successful
@@ -254,7 +254,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -269,7 +269,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -279,7 +279,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + @@ -294,7 +294,7 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + diff --git a/website/docs/warehouse/index.md b/website/docs/services/warehouse/index.md similarity index 90% rename from website/docs/warehouse/index.md rename to website/docs/services/warehouse/index.md index e5504d0..8dbafdf 100644 --- a/website/docs/warehouse/index.md +++ b/website/docs/services/warehouse/index.md @@ -25,7 +25,7 @@ total resources: __1__ ## Resources
diff --git a/website/docs/warehouse/warehouses/index.md b/website/docs/services/warehouse/warehouses/index.md similarity index 93% rename from website/docs/warehouse/warehouses/index.md rename to website/docs/services/warehouse/warehouses/index.md index 23d74ca..9053ca3 100644 --- a/website/docs/warehouse/warehouses/index.md +++ b/website/docs/services/warehouse/warehouses/index.md @@ -40,7 +40,7 @@ The following fields are returned by `SELECT` queries: > -A Snowflake virtual warehouse +successful
stringIdentifier (i.e. name) for the database to which the resource belongs. You can use the /api/v2/databases GET request to get a list of available databases.Identifier (i.e. name) for the database to which the resource belongs. You can use the `/api/v2/databases` GET request to get a list of available databases.
stringIdentifier (i.e. name) for the schema to which the resource belongs. You can use the /api/v2/databases/{database}/schemas GET request to get a list of available schemas for the specified database.Identifier (i.e. name) for the schema to which the resource belongs. You can use the `/api/v2/databases/{database}/schemas` GET request to get a list of available schemas for the specified database.
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.
@@ -54,7 +54,7 @@ A Snowflake virtual warehouse - + @@ -164,7 +164,7 @@ A Snowflake virtual warehouse - + @@ -246,7 +246,7 @@ A Snowflake virtual warehouse -A Snowflake virtual warehouse +successful
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)Name of warehouse (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)Specifies the name of a resource monitor that is explicitly assigned to the warehouse. When a resource monitor is explicitly assigned to a warehouse, the monitor controls the monthly credits used by the warehouse (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
@@ -260,7 +260,7 @@ A Snowflake virtual warehouse - + @@ -370,7 +370,7 @@ A Snowflake virtual warehouse - + @@ -580,12 +580,12 @@ Parameters can be passed in the `WHERE` clause of a query. Check the [Methods](# - + - + @@ -783,7 +783,7 @@ SELECT - 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. + Name of warehouse - name: warehouse_type value: string @@ -836,7 +836,7 @@ SELECT - name: resource_monitor 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. + Specifies the name of a resource monitor that is explicitly assigned to the warehouse. When a resource monitor is explicitly assigned to a warehouse, the monitor controls the monthly credits used by the warehouse - name: comment value: string diff --git a/website/sidebars.js b/website/sidebars.js index 8163755..72e3166 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -30,7 +30,12 @@ const providerTitle = config.title.replace(/^StackQL /, '').replace(/ Provider$/ type: 'category', label: `${providerTitle} Provider`, link: {type: 'doc', id: 'provider-intro'}, - items: [{type: 'autogenerated', dirName: '.'}] + items: [ + { + type: 'autogenerated', + dirName: 'services', + } + ] }, ], };
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)Name of warehouse (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringA 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. (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)Specifies the name of a resource monitor that is explicitly assigned to the warehouse. When a resource monitor is explicitly assigned to a warehouse, the monitor controls the monthly credits used by the warehouse (pattern: ^"([^"]|"")+"|[a-zA-Z_][a-zA-Z0-9_$]*$, example: TEST_NAME)
stringQuery parameter allowing support for different modes of resource creation. Possible values include: - errorIfExists: Throws an error if you try to create a resource that already exists. - orReplace: Automatically replaces the existing resource with the current one. - ifNotExists: Creates a new resource when an alter is requested for a non-existent resource.Query parameter allowing support for different modes of resource creation. Possible values include: - `errorIfExists`: Throws an error if you try to create a resource that already exists. - `orReplace`: Automatically replaces the existing resource with the current one. - `ifNotExists`: Creates a new resource when an alter is requested for a non-existent resource.
booleanQuery parameter that specifies how to handle the request for a resource that does not exist: - true: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - false: The endpoint throws an error if the resource doesn't exist.Query parameter that specifies how to handle the request for a resource that does not exist: - `true`: The endpoint does not throw an error if the resource does not exist. It returns a 200 success response, but does not take any action on the resource. - `false`: The endpoint throws an error if the resource doesn't exist.