Partilhar via

Criar um atalho do Google Cloud Storage (GCS)

Neste artigo, você aprenderá a criar um atalho do Google Cloud Storage (GCS) dentro de uma casa de lago do Fabric. É possível criar atalhos para o Google Cloud Storage (GCS) usando a API XML para GCS. Quando crias atalhos para o Google Cloud Storage, o caminho de destino deve, no mínimo, conter um nome de bucket. Você também pode restringir o escopo do atalho especificando ainda mais o prefixo/pasta para o qual deseja apontar dentro da hierarquia de armazenamento.

Os atalhos do GCS são somente leitura. Eles não suportam operações de gravação, independentemente das permissões do usuário.

Para obter uma visão geral dos atalhos, consulte Atalhos do OneLake. Para criar atalhos programaticamente, consulte as REST APIs de atalhos do OneLake.

Os atalhos do GCS podem tirar proveito do cache de arquivos para reduzir os custos de saída associados ao acesso a dados entre nuvens. Para mais informações, consulte atalhos de cache do OneLake.

Pré-requisitos

Criar um atalho

  1. Abra uma casa no lago.

  2. Clique com o botão direito num diretório dentro da vista do lago da casa do lago.

  3. Selecione Novo atalho.

    Captura de ecrã do menu de contexto ao clicar com o botão direito a mostrar onde selecionar Novo atalho na Lake view.

Selecione uma fonte

  1. Em Fontes externas, selecione Google Cloud Storage.

    Captura de tela da janela Novo atalho mostrando os tipos de atalho disponíveis. A opção intitulada Google Cloud Storage é destacada.

  2. Insira as Configurações de Conexão de acordo com a tabela abaixo:

    Captura de ecrã da janela de atalho Novo a mostrar as definições de Ligação e as credenciais de Ligação.

    Campo Descrição Valor
    URL A string de conexão para o seu bucket do GCS. O nome do bucket é opcional. https:// Nome do Bucket.storage.googleapis.comhttps://storage.googleapis.com
    Ligação As ligações previamente definidas para a localização de armazenamento especificada aparecem no menu suspenso. Se não existirem conexões, crie uma nova ligação. Criar nova conexão
    Nome da ligação O nome definido pelo usuário para a conexão. Um nome para a sua ligação.
    Tipo de autenticação O Fabric usa chaves HMAC (Hash-based Message Authentication Code) para acessar o armazenamento do Google Cloud. Essas chaves estão associadas a uma conta de usuário ou de serviço. A conta deve ter permissão para acessar os dados dentro do bucket GCS. Se o endpoint específico do bucket foi usado na URL da ligação, a conta deve ter as permissões storage.objects.get e storage.objects.list. Se o endpoint global foi usado na URL de conexão, a conta também deve ter essa storage.buckets.list permissão. Chave HMAC
    ID de acesso A chave de acesso associada a uma conta de usuário ou de serviço. Para obter mais informações sobre como criar chaves HMAC, consulte Gerenciar chaves HMAC. A sua chave de acesso.
    Segredo O segredo para a chave de acesso. A sua chave secreta.

  3. Selecione Seguinte.

  4. Navegue até ao local de destino do atalho.

    Captura de tela da janela de navegação de armazenamento com várias pastas selecionadas.

    Se utilizou o endpoint global na URL de conexão, todos os seus buckets disponíveis aparecerão no painel de navegação à esquerda. Se você usou um ponto de extremidade específico do bucket na URL de conexão, somente o bucket especificado e seu conteúdo aparecerão na exibição de navegação.

    Navegue pela conta de armazenamento selecionando uma pasta ou clicando na seta de expansão ao lado de uma pasta.

    Nesta vista, podes selecionar um ou mais locais de destino de atalho. Escolha os locais de destino clicando na caixa de seleção ao lado de uma pasta na exibição de navegação esquerda.

  5. Selecione Seguinte

    Captura de tela da página de revisão de atalho com opções para renomear e excluir atalhos.

    A página de revisão permite que você verifique todas as suas seleções. Aqui você pode ver cada atalho que será criado. Na coluna de ação, você pode clicar no ícone de lápis para editar o nome do atalho. Você pode clicar no ícone da lixeira para excluir o atalho.

  6. Selecione Criar.

A plataforma Lakehouse atualiza automaticamente. O atalho aparece no painel esquerdo do Explorer .

Captura de ecrã mostrando uma lista de tabelas no 'Lake view' que exibem o símbolo de atalho.

Access

Ao configurar a ligação para um atalho GCS, podes especificar o endpoint global para o serviço de armazenamento ou utilizar um endpoint específico do bucket.

  • Exemplo de ponto final global: https://storage.googleapis.com
  • Exemplo de ponto de extremidade específico do bucket: https://<BucketName>.storage.googleapis.com

Authorization

Os atalhos do Google Cloud Storage (GCS) utilizam um modelo de autorização delegada. Neste modelo, o criador do atalho especifica uma credencial para o atalho GCS e todo o acesso a esse atalho é autorizado usando essa credencial. A credencial delegada suportada é uma chave HMAC e um segredo para uma conta de Serviço ou conta de Utilizador.

A conta deve ter permissão para acessar os dados dentro do bucket GCS. Se o ponto final específico do bucket foi utilizado na conexão para o atalho, a conta deve ter as seguintes permissões:

  • storage.objects.get
  • stoage.objects.list

Se o ponto de extremidade global foi usado na conexão para o atalho, a conta deve também ter a seguinte permissão:

  • storage.buckets.list

Limitações

As seguintes limitações aplicam-se aos atalhos do Google Cloud Storage:

  • Os atalhos do GCS são somente leitura. Eles não suportam operações de gravação, independentemente das permissões do usuário.

Conteúdos relacionados

  • Last updated on