Skip to main content

Great Expectations Cloud

Project description

cloud

PyPI Docker Pulls ci pre-commit.ci status Ruff

Quick Start

Python

Install

pip install great_expectations_cloud
Optional Dependencies
pip install 'great_expectations_cloud[sql]'
$ gx-agent --help
usage: gx-agent [-h] [--log-level LOG_LEVEL] [--skip-log-file SKIP_LOG_FILE] [--log-cfg-file LOG_CFG_FILE] [--version]

optional arguments:
  -h, --help            show this help message and exit
  --log-level LOG_LEVEL
                        Level of logging to use. Defaults to WARNING.
  --skip-log-file SKIP_LOG_FILE
                        Skip writing debug logs to a file. Defaults to False. Does not affect logging to stdout/stderr.
  --log-cfg-file LOG_CFG_FILE
                        Path to a logging configuration json file. Supersedes --log-level and --skip-log-file.
  --version             Show the gx agent version.

Set env variables

GX_CLOUD_ACCESS_TOKEN GX_CLOUD_ORGANIZATION_ID

Start the Agent

If you intend to run the agent against local services (Cloud backend or datasources) run the agent outside of the container.

gx-agent

Docker

Building and running the Agent with Docker

Dev Setup

See also CONTRIBUTING.md

  1. Install poetry
  2. Set up virtual environment and install dependencies.
    • poetry install --sync
  3. Activate your virtual environment.
    • poetry shell
  4. Set up precommit hooks
    • pre-commit install

Developer Tasks

Common developer tasks are available via invoke (defined in tasks.py)

invoke --list to see available tasks.

Synchronize Dependencies

To ensure you are using the latest version of the core and development dependencies run poetry install --sync. Also available as an invoke task.

invoke deps

Updating poetry.lock dependencies

The dependencies installed in our CI and the docker build step are determined by the poetry.lock file.

To update only a specific dependency (such as great_expectations) ...

poetry update great_expectations

To resolve and update all dependencies ...

poetry lock

In either case, the updated poetry.lock file must be committed and merged to main.

Release to PyPI and Docker

To release a new version to PyPI the version must be incremented. New versions are automatically published to PyPI when merging to main.

invoke version-bump

A new docker tag will also be generated and pushed to Docker Hub.

Building and Running the GX Agent Image

To build the GX Agent Docker image, run the following in the root dir:

invoke docker

Running the GX Agent:

invoke docker --run

or

docker run --env GX_CLOUD_ACCESS_TOKEN="<GX_TOKEN>" --env GX_CLOUD_ORGANIZATION_ID="<GX_ORG_ID>" gx/agent

Now go into GX Cloud and issue commands for the GX Agent to run, such as generating an Expectation Suite for a Data Source.

Note if you are pushing out a new image update the image tag version in containerize-agent.yaml. The image will be built and pushed out via GitHub Actions.

Example Data

The contents from /examples/agent/data will be copied to /data for the docker container.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

great_expectations_cloud-0.0.35.tar.gz (23.9 kB view details)

Uploaded Source

Built Distribution

great_expectations_cloud-0.0.35-py3-none-any.whl (30.7 kB view details)

Uploaded Python 3

File details

Details for the file great_expectations_cloud-0.0.35.tar.gz.

File metadata

File hashes

Hashes for great_expectations_cloud-0.0.35.tar.gz
Algorithm Hash digest
SHA256 e413e6ab1935c1ef7ea319f49e0d0c07f4b6af7833475793901a669e5f23e8ac
MD5 e50543db370bbd5afcb871e3afb3efc3
BLAKE2b-256 da61d3ec0bf6c401e58b68d19815af7fe51b29d383bfbc91f36a4bfefa22d6ea

See more details on using hashes here.

File details

Details for the file great_expectations_cloud-0.0.35-py3-none-any.whl.

File metadata

File hashes

Hashes for great_expectations_cloud-0.0.35-py3-none-any.whl
Algorithm Hash digest
SHA256 f18e3de22ba46ce8b982c494af10ef34900a4959f553fcb197deba1f4c35e850
MD5 539c54a02ed5060156455c7d59f074c8
BLAKE2b-256 02f2b285db7b57d9627cddd1b7cdcd1a9ec5a5703e4eab2b7fa9d1287e7fa4f3

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page