Skip to content

Commit

Permalink
Details about location usage
Browse files Browse the repository at this point in the history
  • Loading branch information
mosenberg authored Nov 15, 2024
1 parent 8976f6d commit b9e8871
Showing 1 changed file with 25 additions and 0 deletions.
25 changes: 25 additions & 0 deletions website/docs/sql/external/location.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,9 @@ s3_location('amazon_s3_uri'
[, access_key_id => 'text', secret_access_key => 'text' [, session_token => 'text'] ]
[, region => 'text']
)
azure_location('azure_blob_storage_uri'
[, sas_token => 'sas_token']
)
ARRAY[ <source_location> [, ...] ]
```

Expand Down Expand Up @@ -54,6 +57,28 @@ techniques such as concurrent requests, request hedging and
prefetching). For maximum performance, ensure a high network bandwidth
to Amazon S3, e.g., by running HyperAPI directly on an AWS EC2 instance.

## Microsoft Azure Blob Storage

```
SELECT * FROM external(
azure_location(
'abfss://[email protected]/products.parquet', sas_token => 'secret-sas-token'
)
)
```

To access data stored on Microsoft Azure Blob Storage, you can use the
`azure_location` syntax. Hyper supports the `DFS` and `BLOB` endpoints and
recognizes all of the following Azure URL formats:
* `abfss://[email protected]/...`
* `https://account.dfs.core.windows.net/container/...`
* `https://account.blob.core.windows.net/container/...`

Hyper's Azure support is highly optimized by using techniques such as concurrent
requests, request hedging and prefetching. For maximum performance, ensure that you
have a high network bandwidth to Azure Blobl Storage, e.g. by running HyperAPI directly
on Microsoft Azure compute.

## Multiple files

```
Expand Down

0 comments on commit b9e8871

Please sign in to comment.