69 lines
2.5 KiB
Markdown
69 lines
2.5 KiB
Markdown
---
|
|
title: Query Snowflake
|
|
list_title: Snowflake
|
|
description: >
|
|
Use [`sql.from()`](/flux/v0/stdlib/sql/from/) with the `snowflake` driver to query Snowflake.
|
|
menu:
|
|
flux_v0:
|
|
name: Snowflake
|
|
parent: SQL databases
|
|
weight: 101
|
|
related:
|
|
- /flux/v0/stdlib/sql/from/
|
|
list_code_example: |
|
|
```js
|
|
import "sql"
|
|
|
|
sql.from(
|
|
driverName: "snowflake",
|
|
dataSourceName: "user:password@account/db/exampleschema?warehouse=wh",
|
|
query: "SELECT * FROM example_table",
|
|
)
|
|
```
|
|
---
|
|
|
|
To query [Snowflake](https://www.snowflake.com/) with Flux:
|
|
|
|
1. Import the [`sql` package](/flux/v0/stdlib/sql/).
|
|
2. Use [`sql.from()`](/flux/v0/stdlib/sql/from/) and provide the following parameters:
|
|
|
|
- **driverName**: snowflake
|
|
- **dataSourceName**: _See [data source name](#snowflake-data-source-name)_
|
|
- **query**: SQL query to execute
|
|
|
|
```js
|
|
import "sql"
|
|
|
|
sql.from(
|
|
driverName: "snowflake",
|
|
dataSourceName: "user:password@account/db/exampleschema?warehouse=wh",
|
|
query: "SELECT * FROM example_table",
|
|
)
|
|
```
|
|
|
|
---
|
|
|
|
## Snowflake data source name
|
|
The `snowflake` driver uses the following DSN syntaxes (also known as a **connection string**):
|
|
|
|
```
|
|
username[:password]@accountname/dbname/schemaname?param1=value1¶mN=valueN
|
|
username[:password]@accountname/dbname?param1=value1¶mN=valueN
|
|
username[:password]@hostname:port/dbname/schemaname?account=<your_account>¶m1=value1¶mN=valueN
|
|
```
|
|
|
|
## Snowflake to Flux data type conversion
|
|
`sql.from()` converts Snowflake data types to Flux data types.
|
|
|
|
| Snowflake data type | Flux data type |
|
|
| :-------------------------- | :----------------------------------------------------------------------------------------------------------------- |
|
|
| FIXED, NUMBER | [int](/flux/v0/data-types/basic/int/) or [float](/flux/v0/data-types/basic/float/) (depending on decimal size) |
|
|
| REAL, FLOAT | [float](/flux/v0/data-types/basic/float/) |
|
|
| TIMESTAMP_TZ, TIMESTAMP_LTZ | [time](/flux/v0/data-types/basic/time/) |
|
|
| BOOLEAN | [bool](/flux/v0/data-types/basic/bool/) |
|
|
|
|
{{% caption %}}
|
|
All other Snowflake data types (including **TIMESTAMP_NTZ**, **DATE** and **TIME**)
|
|
are converted to strings.
|
|
{{% /caption %}}
|