Skip to content

Latest commit

 

History

History
121 lines (83 loc) · 3.81 KB

storage_config.rst

File metadata and controls

121 lines (83 loc) · 3.81 KB
Raw

Storage Config

TensorBay supports two storage config modes:

  • GRAVITI Storage Config: storage config provided by graviti.
  • Authorized Storage Config: storage config provided by userself.

GRAVITI Storage Config

In graviti storage mode, the data is stored in graviti storage space on TensorBay.

Authorized Storage Config

When using authorized storage config, datasets are stored on user's storage space and are only indexed to the TensorBay. See authorized storage instruction for details about how to configure authorized storage on TensorBay.

TensorBay supports both authorize cloud storage and authorize local storage.

Authorized Cloud Storage

TensorBay SDK supports following methods to configure authorized cloud storage.

  • ~tensorbay.client.gas.GAS.create_oss_storage_config
  • ~tensorbay.client.gas.GAS.create_s3_storage_config
  • ~tensorbay.client.gas.GAS.create_azure_storage_config

For example:

../../../docs/code/storage_config.py

TensorBay SDK supports a method to list a user's all previous configurations.

gas.list_auth_storage_configs()

Create Authorized Storage Dataset

Create a dataset with authorized cloud storage:

dataset_client = gas.create_dataset("dataset_name", config_name="config_name")

Import Cloud Files into Authorized Storage Dataset

Take the following original cloud storage directory as an example:

data/
├── images/
│   ├── 00001.png
│   ├── 00002.png
│   └── ...
├── labels/
│   ├── 00001.json
│   ├── 00002.json
│   └── ...
└── ...

Get a cloud client.

../../../docs/code/storage_config.py

Import the AuthData from original cloud storage and load label file to an authorized storage dataset.

../../../docs/code/storage_config.py

Important

Files will be copied from original directory to the authorized storage dataset path, thus the storage space will be doubled.

Note

Set the authorized storage dataset path the same as original cloud storage directory could speed up the import action. For example, set the config path of above dataset to data/images.

Authorized Local Storage

If you want to use TensorBay service and have the data stored locally at the same time, TensorBay supports authorized local storage config.

Before creating the local storage config via ~tensorbay.client.gas.GAS.create_local_storage_config, you need to start a local storage service. Please contact us on TensorBay for more information.

../../../docs/code/storage_config.py

Then create an authorized local storage dataset with the config.

../../../docs/code/storage_config.py

Other operations such as uploading data and reading data, are the same as datasets created by default, except that the uploaded data is stored under the local storage.