Kedro-Datasets
Welcome to kedro_datasets, the home of Kedro's data connectors. Here you will find AbstractDataset implementations powering Kedro's DataCatalog created by QuantumBlack and external contributors.
Installation
kedro-datasets is a Python plugin. To install it:
pip install kedro-datasets
Install dependencies at a group-level
Datasets are organised into groups e.g. pandas, spark and pickle. Each group has a collection of datasets, e.g.pandas.CSVDataset, pandas.ParquetDataset and more. You can install dependencies for an entire group of dependencies as follows:
pip install "kedro-datasets[<group>]"
This installs Kedro-Datasets and dependencies related to the dataset group. An example of this could be a workflow that depends on the data types in pandas. Run pip install 'kedro-datasets[pandas]' to install Kedro-Datasets and the dependencies for the datasets in the pandas group.
Install dependencies at a type-level
To limit installation to dependencies specific to a dataset:
pip install "kedro-datasets[<group>-<dataset>]"
For example, your workflow might require the pandas.ExcelDataset, so to install its dependencies, run pip install "kedro-datasets[pandas-exceldataset]".
From `kedro-datasets` version 3.0.0 onwards, the names of the optional dataset-level dependencies have been normalised to follow [PEP 685](https://peps.python.org/pep-0685/). The '.' character has been replaced with a '-' character and the names are in lowercase. For example, if you had `kedro-datasets[pandas.ExcelDataset]` in your requirements file, it would have to be changed to `kedro-datasets[pandas-exceldataset]`.
What AbstractDataset implementations are supported?
We support a range of data connectors, including CSV, Excel, Parquet, Feather, HDF5, JSON, Pickle, SQL Tables, SQL Queries, Spark DataFrames and more. We even allow support for working with images.
These data connectors are supported with the APIs of pandas, spark, networkx, matplotlib, yaml and more.
The Data Catalog allows you to work with a range of file formats on local file systems, network file systems, cloud object stores, and Hadoop.
Here is a full list of supported data connectors and APIs.
How can I create my own AbstractDataset implementation?
Take a look at our instructions on how to create your own AbstractDataset implementation.
Can I contribute?
Yes! Want to help build Kedro-Datasets? Check out our guide to contributing.
What licence do you use?
Kedro-Datasets is licensed under the Apache 2.0 License.
Python version support policy
- The Kedro-Datasets package follows the NEP 29 Python version support policy.
4 maintainers
Metadata
4 maintainers
Release files for kedro-datasets 9.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| kedro_datasets-9.6.0.tar.gz | 262.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| kedro_datasets-9.6.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 658.9 kB
Release files / kedro_datasets-9.6.0.tar.gz
| Download URL | kedro_datasets-9.6.0.tar.gz |
|---|---|
| Size | 262.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f6ae5a4638a4ee66492b28a5ef62f9de8684e95a51bab8d76aaa3a0f80e1594a
|
|
BLAKE2b-256 checksum How to use checksums |
2bb3d163d7bb1aa34a605c14221f7255148738a0a3cd4de5776c41603c308c32
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / kedro_datasets-9.6.0-py3-none-any.whl
| Download URL | kedro_datasets-9.6.0-py3-none-any.whl |
|---|---|
| Size | 396.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c850ba8e13c5b05aba7d027cd7466d8c387ecea85c38d3a246dfa5d9d8b3bf2c
|
|
BLAKE2b-256 checksum How to use checksums |
792e773fe0411623bd046b7560ea1abe8637ec118c71386ee642ec9dac21b5e0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
