<p align="center">
<img src="https://raw.githubusercontent.com/localstack/localstack/master/doc/localstack-readme-banner.svg" alt="LocalStack - A fully functional local cloud stack">
</p>
<p align="center">
<a href="https://pypi.org/project/localstack-extension-snowflake/"><img alt="PyPI Version" src="https://img.shields.io/pypi/v/localstack-extension-snowflake?color=blue"></a>
<a href="https://hub.docker.com/r/localstack/snowflake"><img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/localstack/snowflake"></a>
<a href="https://pypi.org/project/localstack-extension-snowflake"><img alt="PyPi downloads" src="https://static.pepy.tech/badge/localstack-extension-snowflake"></a>
<a href="https://github.com/psf/black"><img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg"></a>
<a href="https://twitter.com/localstack"><img alt="Twitter" src="https://img.shields.io/twitter/url/http/shields.io.svg?style=social"></a>
</p>
<p align="center">
LocalStack is a cloud software development framework to develop and test your Snowflake data pipelines locally.
</p>
<p align="center">
<a href="#overview">Overview</a> •
<a href="#installing">Install</a> •
<a href="#quickstart">Quickstart</a> •
<a href="#base-image-tags">Base Image Tags</a> •
<a href="#releases">Releases</a> •
<a href="#support">Support</a> •
<a href="#license">License</a>
<br/>
<a href="https://snowflake.localstack.cloud" target="_blank">📖 Docs</a> •
<a href="https://snowflake.localstack.cloud/references/coverage/" target="_blank">☑️ Function coverage</a>
</p>
---
## Overview
LocalStack is a cloud service emulator that runs in a single container on your laptop or in your CI environment. LocalStack Snowflake emulator replicates the functionality of the real [Snowflake](https://snowflake.com) platform, allowing you to perform operations without an internet connection or a Snowflake account. This is valuable for developing and testing Snowflake data pipelines entirely on the local machine (and in CI pipelines), enabling quick feedback cycles, and not incurring costs of using the real system.
LocalStack Snowflake emulator supports the following features:
- [**Basic operations** on warehouses, databases, schemas, and tables](https://docs.snowflake.com/en/developer-guide/python-connector/python-connector-example)
- [**Storing files** in user/data/named **stages**](https://docs.snowflake.com/en/user-guide/data-load-local-file-system-create-stage)
- [**Snowpark** libraries](https://docs.snowflake.com/en/developer-guide/snowpark/python/index)
- [**Snowpipe** streaming with **Kafka connector**](https://docs.snowflake.com/en/user-guide/data-load-snowpipe-streaming-kafka)
- [**JavaScript and Python UDFs**](https://docs.snowflake.com/en/developer-guide/udf/javascript/udf-javascript-introduction)
- … and more!
## Install
You can use the Snowflake Docker image to run the LocalStack Snowflake emulator. The Snowflake Docker image is available on the [LocalStack Docker Hub](https://hub.docker.com/r/localstack/snowflake). To pull the Snowflake Docker image, execute the following command:
```bash
docker pull localstack/snowflake
```
You can start the Snowflake Docker container using the following methods:
1. [`localstack` CLI](https://docs.localstack.cloud/getting-started/installation/#localstack-cli)
2. [`docker` CLI](https://docs.docker.com/get-docker/)
3. [Docker Compose](https://docs.docker.com/compose/install/)
> **Note**: Before starting, ensure you have a valid `LOCALSTACK_AUTH_TOKEN` to access the LocalStack Snowflake emulator. Refer to the [Auth Token guide](https://docs.localstack.cloud/getting-started/auth-token/) to obtain your Auth Token and specify it in the `LOCALSTACK_AUTH_TOKEN` environment variable.
### `localstack` CLI
To start the Snowflake Docker container using the `localstack` CLI, execute the following command:
```bash
export LOCALSTACK_AUTH_TOKEN=<your-auth-token>
IMAGE_NAME=localstack/snowflake localstack start
```
### `docker` CLI
To start the Snowflake Docker container using the `docker` CLI, execute the following command:
```bash
docker run \
--rm -it \
-p 4566:4566 \
-e LOCALSTACK_AUTH_TOKEN=${LOCALSTACK_AUTH_TOKEN:?} \
localstack/snowflake
```
### Docker Compose
Create a `docker-compose.yml` file with the specified content:
```yaml
version: "3.8"
services:
localstack:
container_name: "localstack-main"
image: localstack/snowflake
ports:
- "127.0.0.1:4566:4566"
environment:
- LOCALSTACK_AUTH_TOKEN=${LOCALSTACK_AUTH_TOKEN:?}
volumes:
- "./volume:/var/lib/localstack"
```
Start the Snowflake Docker container with the following command:
```bash
docker-compose up
```
## Quickstart
After starting the Snowflake Docker container, you can use the [Snowflake Python Connector](https://docs.snowflake.com/en/developer-guide/python-connector.html) to interact with the LocalStack Snowflake emulator. The following example demonstrates how to create a Snowflake table using the Snowflake Python Connector:
```python
connection = snowflake.connector.connect(
user="test",
password="test",
account="test",
database="test",
host="snowflake.localhost.localstack.cloud",
)
connection.cursor().execute("CREATE TABLE table1(col1 INT)")
```
Check out our [documentation](https://snowflake.localstack.cloud) for more examples and guides.
## Base Image Tags
We currently push the `latest` tag as our default tag. This tag is fully tested using our extensive integration test suite. This tag should be used if you want to stay up-to-date with the latest changes.
## Releases
Please refer to our [changelog page](https://snowflake.localstack.cloud/references/changelog/) to see the complete list of changes for each release.
## Support
Get in touch with the LocalStack Team to report issues & request new features, on the following channels:
- [LocalStack Slack Community](https://localstack.cloud/contact/)
- [LocalStack Discussion Page](https://discuss.localstack.cloud/)
- [LocalStack Support email](mailto:support@localstack.cloud)
## License
(c) 2024 LocalStack
Raw data
{
"_id": null,
"home_page": "https://localstack.cloud",
"name": "localstack-extension-snowflake",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "LocalStack",
"author_email": "support@localstack.cloud",
"download_url": "https://files.pythonhosted.org/packages/02/14/68dd1ae7223d55a035f6a86c187c8b56e7e33a7dd9b51dc842ff3190fff3/localstack-extension-snowflake-0.1.24.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <img src=\"https://raw.githubusercontent.com/localstack/localstack/master/doc/localstack-readme-banner.svg\" alt=\"LocalStack - A fully functional local cloud stack\">\n</p>\n\n<p align=\"center\">\n <a href=\"https://pypi.org/project/localstack-extension-snowflake/\"><img alt=\"PyPI Version\" src=\"https://img.shields.io/pypi/v/localstack-extension-snowflake?color=blue\"></a>\n <a href=\"https://hub.docker.com/r/localstack/snowflake\"><img alt=\"Docker Pulls\" src=\"https://img.shields.io/docker/pulls/localstack/snowflake\"></a>\n <a href=\"https://pypi.org/project/localstack-extension-snowflake\"><img alt=\"PyPi downloads\" src=\"https://static.pepy.tech/badge/localstack-extension-snowflake\"></a>\n <a href=\"https://github.com/psf/black\"><img alt=\"Code style: black\" src=\"https://img.shields.io/badge/code%20style-black-000000.svg\"></a>\n <a href=\"https://twitter.com/localstack\"><img alt=\"Twitter\" src=\"https://img.shields.io/twitter/url/http/shields.io.svg?style=social\"></a>\n</p>\n\n<p align=\"center\">\n LocalStack is a cloud software development framework to develop and test your Snowflake data pipelines locally.\n</p>\n\n<p align=\"center\">\n <a href=\"#overview\">Overview</a> \u2022\n <a href=\"#installing\">Install</a> \u2022\n <a href=\"#quickstart\">Quickstart</a> \u2022\n <a href=\"#base-image-tags\">Base Image Tags</a> \u2022\n <a href=\"#releases\">Releases</a> \u2022\n <a href=\"#support\">Support</a> \u2022\n <a href=\"#license\">License</a>\n <br/>\n <a href=\"https://snowflake.localstack.cloud\" target=\"_blank\">\ud83d\udcd6 Docs</a> \u2022\n <a href=\"https://snowflake.localstack.cloud/references/coverage/\" target=\"_blank\">\u2611\ufe0f Function coverage</a>\n</p>\n\n---\n\n## Overview\n\nLocalStack is a cloud service emulator that runs in a single container on your laptop or in your CI environment. LocalStack Snowflake emulator replicates the functionality of the real [Snowflake](https://snowflake.com) platform, allowing you to perform operations without an internet connection or a Snowflake account. This is valuable for developing and testing Snowflake data pipelines entirely on the local machine (and in CI pipelines), enabling quick feedback cycles, and not incurring costs of using the real system.\n\nLocalStack Snowflake emulator supports the following features:\n\n- [**Basic operations** on warehouses, databases, schemas, and tables](https://docs.snowflake.com/en/developer-guide/python-connector/python-connector-example)\n- [**Storing files** in user/data/named **stages**](https://docs.snowflake.com/en/user-guide/data-load-local-file-system-create-stage)\n- [**Snowpark** libraries](https://docs.snowflake.com/en/developer-guide/snowpark/python/index)\n- [**Snowpipe** streaming with **Kafka connector**](https://docs.snowflake.com/en/user-guide/data-load-snowpipe-streaming-kafka)\n- [**JavaScript and Python UDFs**](https://docs.snowflake.com/en/developer-guide/udf/javascript/udf-javascript-introduction)\n- \u2026 and more!\n\n## Install\n\nYou can use the Snowflake Docker image to run the LocalStack Snowflake emulator. The Snowflake Docker image is available on the [LocalStack Docker Hub](https://hub.docker.com/r/localstack/snowflake). To pull the Snowflake Docker image, execute the following command:\n\n```bash\ndocker pull localstack/snowflake\n```\n\nYou can start the Snowflake Docker container using the following methods:\n\n1. [`localstack` CLI](https://docs.localstack.cloud/getting-started/installation/#localstack-cli)\n2. [`docker` CLI](https://docs.docker.com/get-docker/)\n3. [Docker Compose](https://docs.docker.com/compose/install/)\n\n> **Note**: Before starting, ensure you have a valid `LOCALSTACK_AUTH_TOKEN` to access the LocalStack Snowflake emulator. Refer to the [Auth Token guide](https://docs.localstack.cloud/getting-started/auth-token/) to obtain your Auth Token and specify it in the `LOCALSTACK_AUTH_TOKEN` environment variable.\n\n### `localstack` CLI\n\nTo start the Snowflake Docker container using the `localstack` CLI, execute the following command:\n\n```bash\nexport LOCALSTACK_AUTH_TOKEN=<your-auth-token>\nIMAGE_NAME=localstack/snowflake localstack start\n```\n\n### `docker` CLI\n\nTo start the Snowflake Docker container using the `docker` CLI, execute the following command:\n\n```bash\ndocker run \\\n --rm -it \\\n -p 4566:4566 \\\n -e LOCALSTACK_AUTH_TOKEN=${LOCALSTACK_AUTH_TOKEN:?} \\\n localstack/snowflake\n```\n\n### Docker Compose\n\nCreate a `docker-compose.yml` file with the specified content:\n\n```yaml\nversion: \"3.8\"\n\nservices:\n localstack:\n container_name: \"localstack-main\"\n image: localstack/snowflake\n ports:\n - \"127.0.0.1:4566:4566\"\n environment:\n - LOCALSTACK_AUTH_TOKEN=${LOCALSTACK_AUTH_TOKEN:?}\n volumes:\n - \"./volume:/var/lib/localstack\"\n```\n\nStart the Snowflake Docker container with the following command:\n\n```bash\ndocker-compose up\n```\n\n## Quickstart\n\nAfter starting the Snowflake Docker container, you can use the [Snowflake Python Connector](https://docs.snowflake.com/en/developer-guide/python-connector.html) to interact with the LocalStack Snowflake emulator. The following example demonstrates how to create a Snowflake table using the Snowflake Python Connector:\n\n```python\nconnection = snowflake.connector.connect(\n user=\"test\",\n password=\"test\",\n account=\"test\",\n database=\"test\",\n host=\"snowflake.localhost.localstack.cloud\",\n)\nconnection.cursor().execute(\"CREATE TABLE table1(col1 INT)\")\n```\n\nCheck out our [documentation](https://snowflake.localstack.cloud) for more examples and guides.\n\n## Base Image Tags\n\nWe currently push the `latest` tag as our default tag. This tag is fully tested using our extensive integration test suite. This tag should be used if you want to stay up-to-date with the latest changes.\n\n## Releases\n\nPlease refer to our [changelog page](https://snowflake.localstack.cloud/references/changelog/) to see the complete list of changes for each release.\n\n## Support\n\nGet in touch with the LocalStack Team to report issues & request new features, on the following channels:\n\n- [LocalStack Slack Community](https://localstack.cloud/contact/)\n- [LocalStack Discussion Page](https://discuss.localstack.cloud/)\n- [LocalStack Support email](mailto:support@localstack.cloud)\n\n## License\n\n(c) 2024 LocalStack\n",
"bugtrack_url": null,
"license": "",
"summary": "LocalStack Extension: Snowflake",
"version": "0.1.24",
"project_urls": {
"Homepage": "https://localstack.cloud"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "021468dd1ae7223d55a035f6a86c187c8b56e7e33a7dd9b51dc842ff3190fff3",
"md5": "9d3a5ad82e99afdc71dd00c14fd1b8ce",
"sha256": "9e2fbf41408184c1bd87714e45c03a9623af2ae32fe87bbef5832fbe15e406e2"
},
"downloads": -1,
"filename": "localstack-extension-snowflake-0.1.24.tar.gz",
"has_sig": false,
"md5_digest": "9d3a5ad82e99afdc71dd00c14fd1b8ce",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 49559,
"upload_time": "2024-02-29T12:34:02",
"upload_time_iso_8601": "2024-02-29T12:34:02.222698Z",
"url": "https://files.pythonhosted.org/packages/02/14/68dd1ae7223d55a035f6a86c187c8b56e7e33a7dd9b51dc842ff3190fff3/localstack-extension-snowflake-0.1.24.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-29 12:34:02",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "localstack-extension-snowflake"
}
JSON