Aceda aos dados num ponto de acesso a blobs

Um ponto de acesso a um blob comporta-se como um contentor com blobs só de leitura. Ferramentas e serviços que leem a partir do Armazenamento de Blobs podem ler os dados na sua fonte de dados sem alterações de código, desde que utilizem o endpoint Armazenamento de Blobs.

Prerequisites

Navegar nos dados no portal do Azure

Só pode navegar pelos dados no portal Azure em regiões onde a experiência do portal Azure para pontos de acesso blob está disponível. Noutras regiões suportadas, leia dados utilizando a API REST ou outra ferramenta. Consulte Regiões suportadas. Para listar pontos de acesso blob com a API REST, consulte Ler dados com a API REST.

  1. No portal do Azure, vá para sua conta de armazenamento.

  2. Em Armazenamento de dados, selecione Contentores e, em seguida, selecione o separador Pontos de acesso Blob .

    O separador lista cada ponto de acesso blob com a configuração que utiliza.

    Captura de ecrã do separador Pontos de acesso Blob na página Containers de uma conta de armazenamento, com o separador destacado.

  3. Selecione um ponto de acesso a um blob para navegar pelas suas pastas e blobs.

    A barra de ferramentas oferece apenas colunas Atualizar e Editar, porque os blobs são só de leitura. A página também mostra o método de autenticação que o portal utiliza e a configuração que o ponto de acesso do blob utiliza.

    Captura de ecrã de blobs de uma fonte de dados externa num ponto de acesso a blobs, com a barra de ferramentas de leitura destacada.

  4. Para trabalhar com um blob, selecione Mais (...) ao lado dele. Pode visualizar as suas Propriedades, Copiar URL, Descarregá-la ou Gerar SAS.

Ler dados com a API REST

Utilize as mesmas operações de Armazenamento de Blobs que utiliza para qualquer contentor. Use o nome do ponto de acesso blob como nome do contentor.

Em cada pedido, substitua <utc-date-time> pela hora UTC atual no formato RFC 1123, como Mon, 02 Nov 2026 16:00:00 GMT. Substitua <authorization> pelo valor do seu método de autorização. Para mais informações, consulte Autorizar o acesso a dados em Armazenamento do Azure.

Para encontrar os pontos de acesso ao blob numa conta de armazenamento, chame List Containers. Utilize uma função ou assinatura de acesso partilhada com âmbito na conta de armazenamento. Um que está limitado a um único ponto de acesso a um blob não pode listar pontos de acesso a blob.

GET https://<storage-account>.blob.core.windows.net/?comp=list
x-ms-version: 2026-12-06
x-ms-date: <utc-date-time>
Authorization: <authorization>

A resposta lista contentores e pontos de acesso blob em conjunto. Para cada ponto de acesso ao blob, o elemento Properties inclui mais três elementos:

<Container>
  <Name>my-blob-access-point</Name>
  <Properties>
    <!-- Standard container properties -->
    <IsBlobAccessPointContainer>true</IsBlobAccessPointContainer>
    <BlobAccessPointConfigurationName>my-configuration</BlobAccessPointConfigurationName>
    <BlobAccessPointConfigurationUniqueId>configuration-guid</BlobAccessPointConfigurationUniqueId>
  </Properties>
</Container>

Listar Blobs, Obter Propriedades de Blob e Obter Blob não necessitam de um x-ms-version Blob específico. Os exemplos usam 2026-12-06, mas versões anteriores também funcionam.

Para listar blobs, chame List Blobs:

GET https://<storage-account>.blob.core.windows.net/<blob-access-point>?restype=container&comp=list
x-ms-version: 2026-12-06
x-ms-date: <utc-date-time>
Authorization: <authorization>

Se a resposta incluir um NextMarker valor, adicione &marker=<next-marker> ao pedido para obter a página seguinte.

Para obter as propriedades de um blob, chame Obter Propriedades do Blob:

HEAD https://<storage-account>.blob.core.windows.net/<blob-access-point>/<blob-name>
x-ms-version: 2026-12-06
x-ms-date: <utc-date-time>
Authorization: <authorization>

Para descarregar um blob, chame Get Blob:

GET https://<storage-account>.blob.core.windows.net/<blob-access-point>/<blob-name>
x-ms-version: 2026-12-06
x-ms-date: <utc-date-time>
Authorization: <authorization>

Leia dados com ferramentas e bibliotecas de clientes

Ferramentas e bibliotecas de cliente que listam, obtêm propriedades e descarregam blobs através do endpoint Armazenamento de Blobs podem ler a partir de um ponto de acesso a blob. Utilize o nome do ponto de acesso ao blob sempre que a ferramenta pedir o nome do contentor.

Utilizar uma assinatura de acesso partilhado

Para conceder a uma aplicação acesso de leitura com limite de tempo, crie uma assinatura de acesso partilhado (SAS). Conceda apenas as permissões de que a leitura necessita, porque os blobs num ponto de acesso a blobs são apenas de leitura:

  • Para um único blob, crie um blob SAS com permissão de leitura . No portal Azure, selecione Gerar SAS para o blob.
  • Para todo o ponto de acesso de blobs, crie um contentor SAS com permissões de Leitura e de Lista. A permissão de lista funciona apenas num SAS de contentores.

Para obter mais informações, consulte Conceder acesso limitado a dados com assinaturas de acesso compartilhado (SAS).

Use pontos de acesso de blobs com os serviços do Azure

Os serviços Azure que leem a partir do Armazenamento de Blobs podem ler a partir de um ponto de acesso a um blob, desde que utilizem as operações List Blobs, Get Blob Properties e Get Blob. Verifique os seguintes pontos antes de ligar um serviço:

  • Endpoint. O serviço deve ler através do endpoint Armazenamento de Blobs (<storage-account>.blob.core.windows.net). Os pedidos através do endpoint Data Lake Storage (<storage-account>.dfs.core.windows.net) falham.
  • Identidade. Utilize uma identidade gerida para o serviço e atribua-lhe a função de Leitor de Dados de Blocos de Armazenamento na conta de armazenamento.
  • Deteção de alterações. O rastreamento de alterações não está disponível para pontos de acesso ao blob. Os serviços que dependem dele para detetar objetos novos ou eliminados podem não detetar alterações.

Comportamento em modo só de leitura e propriedades dos blobs

  • Os pedidos de escrita, atualização e eliminação de blobs falham com código 409 de estado e código OperationNotSupportedForBlobAccessPointsde erro.
  • O ETag, Last-Modified, e o tamanho (Content-Length) de cada blob provêm da sua fonte de dados. Obter Propriedades do Blob e Obter Blob também retornam cabeçalhos de conteúdo suportados quando a sua fonte de dados os fornece. O nível de acesso é sempre reportado como Hot. Não reflete a classe de armazenamento do objeto na sua fonte de dados. Outras propriedades do Armazenamento de Blobs podem estar em falta ou apresentar valores predefinidos.
  • O Armazenamento do Azure lê dados diretamente da sua fonte de dados para cada pedido, sem cache em memória. Espere uma latência maior do que quando lê dados armazenados no Armazenamento do Azure.
  • As contas de armazenamento que permitem a criação de pontos de acesso a blobs não retornam resultados de List Blobs em formato Apache Arrow. Para mais detalhes, consulte as listagens do Apache Arrow.

Para a lista completa, consulte Limitações e problemas conhecidos com pontos de acesso blob.