khiops-driver-azure 0.0.18

Azure driver for the Khiops tool

khiopsdriver-azure

Khiops driver to enable Azure cloud storage access. khiopsdriver-azure is a cross-platform C++ library. It is a layer above the C++ Azure storage SDK, exposing the storage access functions as a shared library conforming to the Khiops storage driver interface.

Features

• Read/write access to Azure cloud storage blobs and shared files
• Read/write access to Azurite blob storage emulator
• Supports GNU/Linux (distributions using glibc only), macOS and Windows

Storage service authentication

The table below shows the supported methods of authentication.

Authentication method	Azurite storage emulator	Azure cloud storage
Connection string	✔	✔
Environment credentials *		✔
Workload identity credentials		✔
Managed identity credentials		✔
Azure CLI credentials		✔

* Client ID + client secret or certificate environment variables

Distributions

This driver is distributed as multiple package formats:

• DEB package (GitHub Actions workflow)
• RPM package (GitHub Actions workflow)
• pip package (GitHub Actions workflow)
• conda package (recipe repository)

Logging

You can log information, warnings, errors and debug traces to a file using the following environment variables (they must both be defined to log anything):

• AZURE_DRIVER_LOGLEVEL: available values are off, critical, error, warning, info, debug, trace (they are actually the values of the spdlog logging library)
• AZURE_DRIVER_LOGFILE: path to the log file (which does not need to already exist).

Tip: you can define AZURE_DRIVER_LOGFILE to be /dev/stderr or /dev/stdout if you want to log to standard error or standard output, respectively.

Technical information

This driver must be compiled with a compiler supporting at least C++14.

This repository also contains a test suite using GoogleTest.

The build tool used to compile the code into a library is CMake. Presets are available, using Ninja as the default generator.

The dependencies of this driver come from vcpkg, a revision of which is referenced by this repository as a Git submodule.

Other drivers

You may also want to use:

• Amazon S3 driver: https://github.com/KhiopsML/khiopsdriver-s3
• Google Cloud Storage driver: https://github.com/KhiopsML/khiopsdriver-gcs