Compartilhar via

Criar um atalho do Google Cloud Storage (GCS)

Neste artigo, você aprenderá a criar um atalho do GCS (Google Cloud Storage) em um lakehouse do Fabric. A API XML para Google Cloud Storage (GCS) pode ser usada para criar atalhos para o GCS. Quando você cria atalhos para o Google Cloud Storage, o caminho de destino deve conter no mínimo um nome de bucket. Você também pode restringir o escopo do atalho especificando ainda mais o prefixo ou a pasta para o qual deseja apontar dentro da hierarquia de armazenamento.

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

Para obter uma visão geral dos atalhos, confira Atalhos do OneLake. Para criar atalhos por meio de programação, veja APIs REST dos atalhos do OneLake.

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

Pré-requisitos

Criar um atalho

  1. Abra uma casa de lago.

  2. Clique com o botão direito do mouse em um diretório no modo de exibição de Lake do lakehouse.

  3. Selecione Novo atalho.

    Captura de tela do menu de contexto do clique com o botão direito do mouse mostrando onde selecionar Novo atalho no modo de exibição do Lake.

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 está em destaque.

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

    Captura de tela da janela de atalho novo mostrando as configurações de conexão e as credenciais de conexão.

    Campo Descrição Valor
    URL A cadeia de conexão para seu bucket do GCS. O nome do bucket é opcional. https:// BucketName.storage.googleapis.comhttps://storage.googleapis.com
    Conexão As conexões definidas anteriormente para o local de armazenamento especificado aparecem no menu suspenso. Se não houver conexões, crie uma nova. Criar nova conexão
    Nome da conexão O nome definido pelo usuário para a conexão. Um nome para a conexão.
    Tipo de autenticação O Fabric usa chaves do Código de Autenticação de Mensagens baseado em Hash (HMAC) para acessar o armazenamento do Google Cloud. Essas chaves são associadas a uma conta de usuário ou serviço. A conta deve ter permissão para acessar os dados dentro do bucket do GCS. Se o ponto de extremidade específico do bucket foi usado na URL de conexã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 a permissão storage.buckets.list. Chave HMAC
    ID de acesso A chave de acesso associada a uma conta de usuário ou serviço. Para obter mais informações sobre como criar chaves HMAC, confira Gerenciar chaves HMAC. Sua chave de acesso.
    Segredo O segredo para a chave de acesso. A chave secreta.

  3. Selecione Avançar.

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

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

    Se você usou o ponto de extremidade global na URL de conexão, todos os seus buckets disponíveis aparecerão na exibição 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.

    Nessa exibição, você pode 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 da esquerda.

  5. Selecione Avançar

    Captura de tela da página de revisão de atalhos 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.

O lakehouse é atualizado automaticamente. O atalho aparece no painel à esquerda do Explorer.

Captura de tela mostrando uma lista de tabelas da visualização de Lake que exibem o símbolo de atalho.

Access

Ao configurar a conexão para um atalho do GCS, é possível especificar o ponto de extremidade global do serviço de armazenamento ou usar um ponto de extremidade específico do bucket.

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

Authorization

Os atalhos do GCS usam um modelo de autorização delegada. Nesse modelo, o criador do atalho especifica uma credencial para o atalho do GCS e todo o acesso a esse atalho é autorizado utilizando essa credencial. A credencial delegada suportada é uma chave HMAC e um segredo para uma conta de serviço ou uma conta de usuário.

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

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

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

  • storage.buckets.list

Limitações

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

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

Conteúdo relacionado

  • Last updated on