Launch Binder — open this README in JupyterLab
Part of a concise lab series covering fundamentals (100-level) and integrations (200-level).
Welcome to the Opteryx Labs. These hands-on modules demonstrate how to use Opteryx Cloud (https://opteryx.app) to query and analyze data without managing infrastructure. Modules are brief, practice-focused exercises suitable for individual learning or small-group workshops.
To follow these labs you'll need an Opteryx Cloud account (https://opteryx.app).
The labs are organized as a concise curriculum with progressive modules and clear learning objectives. Each module is practical and exercise-driven — suitable for self-study.
-
Lab 101.01 - Simple Query & Display: Introduces connecting to Opteryx Cloud from Python and executing basic SQL queries. Covers authentication and querying shared datasets.
-
Lab 101.02 - Upload to Opteryx Cloud: Demonstrates using the Upload API to start a session, upload file parts, inspect session contents, and commit an upload to create a table or snapshot.
-
Lab 101.03 - Query Uploaded Data: Shows how to query tables or snapshots produced by uploads using SQL, and how to integrate results into analysis workflows.
-
Lab 201.01 - Query via OData: Demonstrates querying Opteryx Cloud with the OData v4 API, suitable for BI tools or REST-based integrations. Includes examples for service discovery, metadata retrieval, and data queries.
- Python 3.9 or later
- An Opteryx Cloud account (register free)
- Your Opteryx Cloud credentials (username and API token from your account settings)
- Basic knowledge of SQL and Python to be able to follow the examples
Each lab is a Jupyter Notebook. To get started:
- Create an Opteryx Cloud account (https://opteryx.app)
- Create an access token in your account settings (or use client credentials)
- Open a lab notebook and provide credentials via environment variables or input prompts
- Run the cells to execute the examples and exercises
Run without local setup (Binder)
You can run the labs without installing anything locally by launching them on Binder. This starts a temporary Jupyter environment with notebooks and dependencies pre-installed — useful for quick trials.
Opteryx Cloud is a fully managed Cloud Datawarehouse that lets you focus on data analysis instead of infrastructure. Connect from Python, any SQL client, or build custom applications—no setup required. Query across multiple data sources, leverage powerful analytics capabilities, and collaborate with your team.
Learn more at opteryx.app or check out the Opteryx documentation.
We welcome contributions to the Opteryx Labs! If you have suggestions for improvements or new lab ideas, please feel free to submit a pull request or open an issue via GitHub. Your input is invaluable in keeping the labs up-to-date and relevant.
All content in the Opteryx Labs repository is provided under the Apache 2.0 License - see the LICENSE file for details.
Create an Opteryx Cloud account at https://opteryx.app and start exploring the labs at your own pace.