Skip to content

Commit f524cda

Browse files
MeelahMejstirnaman
authored andcommitted
Restructuring, reving, and proof reading edit
1 parent 25f2d83 commit f524cda

File tree

1 file changed

+69
-34
lines changed

1 file changed

+69
-34
lines changed

content/shared/influxdb3-query-guides/snapshots/snowflake.md

Lines changed: 69 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,22 @@ Export time series data snapshots from InfluxDB into Apache Iceberg format and q
1515

1616
Before you begin, ensure you have the following:
1717

18-
- A **Snowflake account** with necessary permissions.
19-
- Access to an **external object store** (such as AWS S3).
20-
- Familiarity with **Apache Iceberg** and **Snowflake**.
18+
- **InfluxDB Cloud Dedicated plan** or compatible environment
19+
- **Snowflake account** with appropriate permissions
20+
- **External object store** (AWS S3, Azure Blob Storage, or GCP)
21+
22+
## Request Iceberg Integration
23+
24+
1. Contact [InfluxData sales](https://www.influxdata.com/contact-sales/) to request Iceberg integration.
25+
26+
2. Be prepared to provide:
27+
- Your organization ID
28+
- Customer name
29+
- Cloud provider and region
30+
- External storage details (bucket name, region, permissions)
31+
- Technical contact information
32+
33+
> **Note**: Iceberg integration is a premium feature that requires setup by the InfluxData team.
2134
2235
## Integrate InfluxDB 3 with Snowflake
2336

@@ -42,7 +55,7 @@ STORAGE_INTEGRATION=my_storage_integration;
4255

4356
### Set up a catalog integration in Snowflake
4457

45-
Set up a catalog integration in Snowflake to manage and load Iceberg tables efficiently.
58+
Your support engineer will help you set up a catalog integration in Snowflake to manage and load Iceberg tables efficiently.
4659

4760
#### Example: Create a catalog integration in Snowflake
4861

@@ -59,7 +72,58 @@ For more information, refer to the [Snowflake documentation](https://docs.snowfl
5972

6073
> **Note**: Before exporting InfluxDB time series data to Iceberg format, ensure that the relevant InfluxDB tables are properly set up. Please reach out to your support engineers to configure the tables that need to be exported.
6174
62-
Use the InfluxDB Iceberg exporter to convert and export your time-series data from your {{% product-name omit="Clustered" %}} cluster to the Iceberg table format.
75+
{{< tabs-wrapper >}}
76+
{{% tabs %}}
77+
[CLI](#tab-cli)
78+
[API](#tab-api)
79+
{{% /tabs %}}
80+
81+
{{% tab-content %}}
82+
{{% tab-pane id="tab-cli" %}}
83+
84+
#### Using the CLI
85+
86+
Use the `influxctl` command to export InfluxDB time-series data to Iceberg format:
87+
88+
```sh
89+
influxctl snapshot export --namespace foo --table bar
90+
```
91+
92+
{{% /tab-pane %}}
93+
{{% tab-pane id="tab-api" %}}
94+
95+
#### Using the API
96+
97+
Use the {{% product-name %}} HTTP API to export snapshots and check status.
98+
99+
##### Example: Export a snapshot
100+
101+
This example demonstrates how to export a snapshot of your data from InfluxDB to an Iceberg table using the HTTP API.
102+
103+
- **Method**: `POST`
104+
- **Endpoint**: `/snapshots/export`
105+
- **Request body**:
106+
107+
```json
108+
{
109+
"namespace": "foo",
110+
"table": "bar"
111+
}
112+
```
113+
The `POST` request to the `/snapshots/export` endpoint triggers the export of data from the specified namespace and table in InfluxDB to an Iceberg table. The request body specifies the namespace (`foo`) and the table (`bar`) to be exported.
114+
115+
##### Example: Check snapshot status
116+
117+
This example shows how to check the status of an ongoing or completed snapshot export using the HTTP API.
118+
119+
- **Method**: `GET`
120+
- **Endpoint**: `/snapshots/status`
121+
122+
The `GET` request to the `/snapshots/status` endpoint retrieves the status of the snapshot export. This can be used to monitor the progress of the export or verify its completion.
123+
124+
{{% /tab-pane %}}
125+
{{% /tab-content %}}
126+
{{< /tabs-wrapper >}}
63127

64128
#### Creating a configuration file
65129

@@ -118,35 +182,6 @@ SELECT * FROM my_iceberg_table
118182
WHERE timestamp > '2025-01-01';
119183
```
120184

121-
### Use the API to manage and configure snapshots
122-
123-
Use the {{% product-name %}} HTTP API to export snapshots and check status.
124-
125-
#### Example: Export a snapshot
126-
127-
This example demonstrates how to export a snapshot of your data from InfluxDB to an Iceberg table using the HTTP API.
128-
129-
- **Method**: `POST`
130-
- **Endpoint**: `/snapshots/export`
131-
- **Request body**:
132-
133-
```json
134-
{
135-
"namespace": "foo",
136-
"table": "bar"
137-
}
138-
```
139-
The `POST` request to the `/snapshots/export` endpoint triggers the export of data from the specified namespace and table in InfluxDB to an Iceberg table. The request body specifies the namespace (`foo`) and the table (`bar`) to be exported.
140-
141-
#### Example: Check snapshot status
142-
143-
This example shows how to check the status of an ongoing or completed snapshot export using the HTTP API.
144-
145-
- **Method**: `GET`
146-
- **Endpoint**: `/snapshots/status`
147-
148-
The `GET` request to the `/snapshots/status` endpoint retrieves the status of the snapshot export. This can be used to monitor the progress of the export or verify its completion.
149-
150185
## Considerations and limitations
151186

152187
When exporting data from InfluxDB to an Iceberg table, keep the following considerations and limitations in mind:

0 commit comments

Comments
 (0)