Skip to content

Commit 145fa84

Browse files
JV0812parth-sumojpipkin1
authored
Update snowflake-sql-api.md (#5815)
* Add API link * minor fix * Update snowflake-sql-api.md * Update snowflake-sql-api.md * minor fix * Update docs/send-data/hosted-collectors/cloud-to-cloud-integration-framework/snowflake-sql-api.md Co-authored-by: John Pipkin (Sumo Logic) <[email protected]> * Update docs/send-data/hosted-collectors/cloud-to-cloud-integration-framework/snowflake-sql-api.md Co-authored-by: John Pipkin (Sumo Logic) <[email protected]> --------- Co-authored-by: Parth Langalia <[email protected]> Co-authored-by: John Pipkin (Sumo Logic) <[email protected]>
1 parent 183943f commit 145fa84

File tree

3 files changed

+13
-19
lines changed

3 files changed

+13
-19
lines changed

‎docs/send-data/hosted-collectors/cloud-to-cloud-integration-framework/snowflake-sql-api.md‎

Lines changed: 11 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -24,8 +24,9 @@ Customers can provide custom SQL queries for the source to execute and a configu
2424
To collect metric data from the Snowflake SQL API, you must have an authorized Snowflake account. We suggest setting up a dedicated user account with the correct permissions for accessing the SQL tables with the data you are interested in collecting.
2525

2626
1. Create a user account with the correct permissions for accessing the SQL tables you plan to query.
27-
1. Take note of your admin account identifier following the instructions [here](https://docs.snowflake.com/en/user-guide/admin-account-identifier). The identifier should look something like this: `wp00000.us-east-2.aws`.
27+
1. Collect your admin account identifier following the instructions in the [Snowflake documentation](https://docs.snowflake.com/en/user-guide/admin-account-identifier). The identifier should look something like this: `wp00000.us-east-2.aws`.
2828
1. Take note of the database name you plan to query.
29+
1. Collect your Snowflake Programmatic Access Token following the instructions in the [Snowflake documentation](https://docs.snowflake.com/en/user-guide/programmatic-access-tokens).
2930
1. Optional additional information such as a role, warehouse, or schema name can also be configured with the source.
3031

3132
### Source configuration
@@ -41,9 +42,13 @@ To configure the Snowflake SQL API Source:
4142
1. (Optional) **Fields**. Click the **+Add Field** link to define the fields you want to associate. Each field needs a name (key) and value.
4243
* <img src={useBaseUrl('img/reuse/green-check-circle.png')} alt="green check circle.png" width="20"/> A green circle with a check mark is shown when the field exists and is enabled in the Fields table schema.
4344
* <img src={useBaseUrl('img/reuse/orange-exclamation-point.png')} alt="orange exclamation point.png" width="20"/> An orange triangle with an exclamation point is shown when the field doesn't exist in the Fields table schema. In this case, you'll see an option to automatically add or enable the nonexistent fields to the Fields table schema. If a field is sent to Sumo Logic that does not exist in the Fields schema it is ignored, known as dropped.
44-
1. In **Snowflake Username**, enter your Snowflake account username.
45-
1. In **Snowflake Password**, enter the Snowflake account password associated with your user.
4645
1. In **Snowflake Account Identifier**, enter your Snowflake account identifier obtained from the vendor configuration above. The identifier should look something like this: `wp00000.us-east-2.aws`.
46+
1. **Authentication Configuration**. Sumo Logic provides two different ways to configure: **Basic** and **Programmatic Access Token**.
47+
- **Basic**:
48+
1. In **Snowflake Username**, enter your Snowflake account username.
49+
1. In **Snowflake Password**, enter the Snowflake account password associated with your user.
50+
- **Programmatic Access Token**:
51+
1. In **Snowflake Programmatic Access Token**, enter your Programmatic Access Token collected from the [Snowflake platform](#vendor-configuration).
4752
1. In **Snowflake Database**, enter your Snowflake database. Separate sources are required to query separate databases.
4853
1. In **SQL Statement Metric Configuration**, upload a JSON file containing the SQL queries to execute, their polling interval, and additional configuration for translating the results to metrics.
4954
1. (Optional) In **Snowflake Role**, provide a database role if required.
@@ -86,28 +91,15 @@ Sources can be configured using UTF-8 encoded JSON files with the Collector Ma
8691

8792
### Configuration Object
8893

89-
| Parameter | Type | Required | Default | Description | Example |
90-
|:----------|:-------|:---------|:--------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-------------|
94+
| Parameter | Type | Required | Default | Description | Example |
95+
|:--|:--|:--|:--|:--|:--|
9196
| name | String | Yes | `null` | Type a desired name of the source. The name must be unique per collector. This value is assigned to the [metadata](/docs/search/get-started-with-search/search-basics/built-in-metadata) field `_source`. | `"mySource"` |
9297
| description | String | No | `null` | Type a description of the source. | `"Testing source"`
9398
| category | String | No | `null` | Type a category of the source. This value is assigned to the [metadata](/docs/search/get-started-with-search/search-basics/built-in-metadata) field `_sourceCategory`. See [best practices](/docs/send-data/best-practices) for details. | `"mySource/test"`
9499
| fields | JSON Object | No | `null` | JSON map of key-value fields (metadata) to apply to the collector or source. | |
95100
| username | String | Yes | `null` | Your Snowflake user account. | |
96101
| password | String | Yes | `null` | Your Snowflake user password. | |
97-
| accountIdentifier | String | Yes | `null` | Your Snowflake admin account identifier. | `wp00000.us-east-2.aws` |
98-
| database | String | Yes | `null` | Your Snowflake database name. | `SNOWFLAKE` |
99-
| MetricConfigSection | String | Yes | `null` | A stringified JSON of the metrics configuration. | See above documentation for examples. |
100-
101-
### Configuration Object
102-
103-
| Parameter | Type | Required | Default | Description | Example |
104-
|:----------|:-------|:---------|:--------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-------------|
105-
| name | String | Yes | `null` | Type a desired name of the source. The name must be unique per collector. This value is assigned to the [metadata](/docs/search/get-started-with-search/search-basics/built-in-metadata) field `_source`. | `"mySource"` |
106-
| description | String | No | `null` | Type a description of the source. | `"Testing source"`
107-
| category | String | No | `null` | Type a category of the source. This value is assigned to the [metadata](/docs/search/get-started-with-search/search-basics/built-in-metadata) field `_sourceCategory`. | `"mySource/test"`
108-
| fields | JSON Object | No | `null` | JSON map of key-value fields (metadata) to apply to the collector or source. | |
109-
| username | String | Yes | `null` | Your Snowflake user account. | |
110-
| password | String | Yes | `null` | Your Snowflake user password. | |
102+
| patToken | String | Yes | `null` | Your Snowflake programmatic access token. | |
111103
| accountIdentifier | String | Yes | `null` | Your Snowflake admin account identifier. | `wp00000.us-east-2.aws` |
112104
| database | String | Yes | `null` | Your Snowflake database name. | `SNOWFLAKE` |
113105
| MetricConfigSection | String | Yes | `null` | A stringified JSON of the metrics configuration. | See above documentation for examples. |

‎static/files/c2c/snowflake-sql-api/example.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
"source":{
44
"config":{
55
"name": "Snowflake C2C",
6+
"authType": "basic",
67
"username": "sumosnowflake",
78
"password": "*************",
89
"accountIdentifier": "wp71650.us-east-2.aws",

‎static/files/c2c/snowflake-sql-api/example.tf‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@ resource "sumologic_cloud_to_cloud_source" "snowflake_metrics_source" {
55
}
66
config = jsonencode({
77
"name": "Snowflake C2C",
8+
"authType": "basic",
89
"username": "sumosnowflake",
910
"password": "*************",
1011
"accountIdentifier": "wp71650.us-east-2.aws",

0 commit comments

Comments
 (0)