The gooddata-sdk
package provides a clean and convenient Python API to interact with GoodData.
At the moment the SDK provides services to inspect and interact with the Semantic Model and consume analytics:
- Catalog Workspaces Service
- Catalog Workspace Content Service
- Catalog Data Source Service
- Catalog User Service
- Catalog Permission Service
- Catalog Organization Service
- Visualizations Service
- Compute Service
- Table Service
See DOCUMENTATION for more details.
- GoodData Cloud or GoodData.CN installation
- Python 3.9 or newer
Run the following command to install the gooddata-sdk
package on your system:
pip install gooddata-sdk
Compute an visualization:
import gooddata_sdk
# GoodData host in the form of uri
host = "http://localhost:3000"
# GoodData user token
token = "some_user_token"
sdk = gooddata_sdk.GoodDataSdk.create(host, token)
workspace_id = "demo"
visualization_id = "customers_trend"
# reads visualization from workspace
visualization = sdk.visualizations.get_visualization(workspace_id, visualization_id)
# triggers computation for the visualization. the result will be returned in a tabular form
table = sdk.tables.for_visualization(workspace_id, visualization)
# and this is how you can read data row-by-row and do something with it
for row in table.read_all():
print(row)
Please use the GitHub issue tracker to submit bugs or request features.
See Github releases for released versions and a list of changes.