Docs
Plugins
Destinations
Azure Blob Storage
Overview

Azure Blob Storage Destination Plugin

Latest: v3.2.0

This destination plugin lets you sync data from a CloudQuery source to remote Azure Blob Storage storage in various formats such as CSV, JSON and Parquet.

Authentication

The plugin needs to be authenticated with your Azure account in order to fetch information about your cloud setup.

You can either authenticate with az login (when running locally), or by using a "service principal" and exporting environment variables (appropriate for automated deployments).

You can find out more about authentication with Azure at Azure's documentation (opens in a new tab) for the Go SDK.

Example

This example configures an Azure blob storage destination, to create CSV files in https://cqdestinationazblob.blob.core.windows.net/test/path/to/files. Note that the Azure blob storage plugin only supports append write-mode.

The (top level) spec section is described in the Destination Spec Reference.

kind: destination
spec:
  name: "azblob"
  path: "cloudquery/azblob"
  version: "v3.2.0"
  write_mode: "append" # this plugin only supports 'append' mode
  # batch_size: 10000 # optional
  # batch_size_bytes: 5242880 # optional
  spec:
    storage_account: "cqdestinationazblob"
    container: "test"
    path: "path/to/files"
    format: "csv"
    format_spec:
      delimiter: ","

The Azure blob destination utilizes batching, and supports batch_size and batch_size_bytes.

Azure Blob Spec

This is the (nested) spec used by the Azure blob destination Plugin.

  • storage_account (string) (required)

    Storage account where to sync the files.

  • container (string) (required)

    Storage container inside the storage account where to sync the files.

  • path (string) (required)

    Path to where the files will be uploaded in the above bucket.

  • format (string) (required)

    Format of the output file. Supported values are csv, json and parquet.

  • format_spec (map format_spec) (optional)

    Optional parameters to change the format of the file

format_spec

  • delimiter (string) (optional) (default: ,)

    Character that will be used as want to use as the delimiter if the format type is csv

  • skip_header (bool) (optional) (default: false)

    Specifies if the first line of a file should be the headers (when format is csv).