Skip to content

Azure Blob Storage

Install

See the Install guide for the full setup, including Windows PowerShell.

curl -fsSL https://install.skippr.io/install.sh | shClick to copy

Writes Parquet files to Azure Blob Storage.

Configuration

yaml
warehouse:
  kind: azure_blob
  account_name: mystorageaccount
  account_key: ${AZURE_BLOB_ACCOUNT_KEY}
  container: my-container
  prefix: "data/"
FieldDefaultDescription
account_name(required)Azure storage account name
account_keyAccess key (one of key/sas required)
sas_tokenSAS token
container(required)Blob container name
prefixKey prefix for uploaded objects

Authentication

Authenticate with either an account key or a SAS token. For security best practices, we strongly advise against storing the account key or SAS token in skippr.yaml. Use environment variable interpolation instead: replace the account_key or sas_token value with your own ${ENV_VAR} reference.

The relevant part of skippr.yaml looks like this:

yaml
warehouse:
  kind: azure_blob
  account_key: ${AZURE_BLOB_ACCOUNT_KEY}
  # or:
  # sas_token: ${AZURE_BLOB_SAS_TOKEN}

Set the env var before running skippr:

macOS / Linux

bash
export AZURE_BLOB_ACCOUNT_KEY="base64key..."

Windows PowerShell

powershell
$env:AZURE_BLOB_ACCOUNT_KEY = "base64key..."

Windows Command Prompt

cmd
set AZURE_BLOB_ACCOUNT_KEY=base64key...

Permissions or Network Requirements

The storage principal needs write access to the selected container and prefix, and the runner must be able to reach Azure Blob Storage over the network.

Troubleshooting

SymptomFix
authentication failedVerify the storage account name, account key or SAS token, and container name.
writes failCheck container permissions, prefix values, and any firewall restrictions on the storage account.

Next steps

Install

See the Install guide for the full setup, including Windows PowerShell.

curl -fsSL https://install.skippr.io/install.sh | shClick to copy