Installation

Before installing, ensure you are using:

Python 3.10 or newer
GoodData.CN or GoodData Cloud
The pip package management tool

To install the gooddata-sdk Python SDK package, run the following command:

pip3 install gooddata-sdk

Known macOS issue

If you are getting the following message:

(Caused by SSLError(SSLCertVerificationError(1, ‘[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:1129)’)))

it is likely caused by Python, and it occurs if you have installed Python directly from python.org.

To mitigate, please install your SSL certificates in HD -> Applications -> Python -> Install Certificates.command.

To make use of the package, you need a running instance of GoodData. If you do not have GoodData yet, sign up for a trial of GoodData Cloud.

Versioning

The Python SDK is versioned and usually released in tandem with GoodData Cloud.

GoodData Cloud

When working with GoodData Cloud, we recommend you always work with the newest Python SDK available.

Python Version Support

The Python SDK follows the official Python release cycle and end-of-life schedule. When a Python version reaches its end of life, support for that version will be dropped as part of a regular minor release, not a major release. We recommend keeping your Python environment up to date with actively supported versions.

Troubleshooting

In case of any issues with Python SDK, feel free to reach out to us on our community slack or create a GitHub issue.

Getting Started