Como criar um link de recurso para uma tabela compartilhada do catálogo de dados

Você pode criar um link de recurso para uma tabela compartilhada em qualquer AWS região usando o AWS Lake Formation console,API, ou AWS Command Line Interface (AWS CLI).

Como criar um link de recurso para a tabela compartilhada (console)

1. Abra o AWS Lake Formation console em https://console.aws.amazon.com/lakeformation/. Faça login como entidade principal que tem a permissão CREATE_TABLE do Lake Formation no banco de dados para conter o link do recurso.

2. No painel de navegação, escolha Tabelas e, em seguida, escolha Criar, link do recurso.

3. Na página Criar link de recurso, forneça as seguintes informações:

   Nome do link de recurso

   Digite um nome que siga as mesmas regras de um nome de tabela. O nome pode ser o mesmo da tabela compartilhada de destino.

   Banco de dados

   O banco de dados no catálogo de dados local para conter o link do recurso.

   Região do proprietário de tabela compartilhada

   Se você estiver criando o link do recurso em uma região diferente, selecione a região da tabela compartilhada de destino.

   Tabela compartilhada

   Selecione uma tabela compartilhada na lista ou digite um nome de tabela local (de propriedade) ou compartilhada.

   A lista contém todas as tabelas compartilhadas com sua conta. Anote o banco de dados e o ID da conta do proprietário listado em cada tabela. Caso você não veja uma tabela que saiba que foi compartilhada com sua conta, verifique o seguinte:

   • Se você não for administrador do data lake, verifique se o administrador do data lake concedeu a você as permissões do Lake Formation na tabela.

   • Se você for administrador de um data lake e sua conta não estiver na mesma organização da AWS da conta concedente, certifique-se de ter aceitado o convite de compartilhamento de recursos AWS Resource Access Manager (AWS RAM) para o banco de dados. Para obter mais informações, consulte Aceitando um convite de compartilhamento de recursos do AWS RAM.

   Banco de dados da tabela compartilhada

   Se você selecionou uma tabela compartilhada na lista, esse campo será preenchido com o banco de dados da tabela compartilhada na conta externa. Caso contrário, digite um banco de dados local (para um link de recurso para uma tabela local) ou o banco de dados da tabela compartilhada na conta externa.

   Proprietário de tabela compartilhada

   Se você selecionou uma tabela compartilhada na lista, esse campo será preenchido com o ID da conta do proprietário da tabela compartilhada. Caso contrário, insira o ID da sua AWS conta (para um link de recurso para uma tabela local) ou o ID da AWS conta que compartilhou a tabela.

4. Selecione Criar para criar o link do recurso.

   Em seguida, você pode exibir o nome do link do recurso na coluna Nome na página Tabelas.

5. (Opcional) Conceda a permissão DESCRIBE do Lake Formation no link do recurso às entidades principais que devem ser capazes de exibir o link e acessar a tabela de destino.

   No entanto, conceder permissões em um link de recurso não concede permissões no banco de dados ou na tabela de destino (vinculado). Você deve conceder permissões no banco de dados de destino separadamente para que o link da tabela/recurso fique visível no Athena.

Como criar um link de recurso para uma tabela compartilhada na mesma região (AWS CLI)

1. Digite um comando semelhante ao seguinte:

   aws glue create-table --database-name myissues --table-input '{"Name":"my_customers","TargetTable":{"CatalogId":"111122223333","DatabaseName":"issues","Name":"customers"}}'

   Esse comando cria um link de recurso chamado my_customers para a tabela compartilhada customers, que está no banco de dados issues na conta AWS 1111-2222-3333. O link do recurso é armazenado no banco de dados local myissues.

2. (Opcional) Conceda a permissão DESCRIBE do Lake Formation no link do recurso às entidades principais que devem ser capazes de exibir o link e acessar a tabela de destino.

   No entanto, conceder permissões em um link de recurso não concede permissões na tabela de destino (vinculada). Você deve conceder permissões no banco de dados de destino separadamente para que o link da tabela/recurso fique visível no Athena.

Como criar um link de recurso para uma tabela compartilhada em uma região diferente (AWS CLI)

1. Digite um comando semelhante ao seguinte:

   aws glue create-table --region eu-west-1 --cli-input-json '{
       "CatalogId": "111122223333",
       "DatabaseName": "ireland_db",
       "TableInput": {
           "Name": "rl_useast1salestb_ireland",
           "TargetTable": {
               "CatalogId": "444455556666",
               "DatabaseName": "useast1_salesdb",
               "Region": "us-east-1",
               "Name":"useast1_salestb"
           }
       }
   }‘

   Esse comando cria um link de recurso nomeado rl_useast1salestb_ireland na região da Europa (Irlanda) para a tabela compartilhadauseast1_salestb, que está no banco de dados na AWS conta 444455556666 useast1_salesdb na região Leste dos EUA (Norte da Virgínia). O link do recurso é armazenado no banco de dados local ireland_db.

2. Conceda permissão DESCRIBE ao Lake Formation às entidades principais que devem ser capazes de exibir o link e acessar o destino do link por meio do link.

   No entanto, conceder permissões em um link de recurso não concede permissões na tabela de destino (vinculada). Você deve conceder permissões na tabela de destino separadamente para que o link da tabela/recurso fique visível no Athena.

Consulte também:

• Como os links de recursos funcionam no Lake Formation

• DESCRIBE