Gestão de links de recursos em APIs do AWS Glue.
As tabelas a seguir explicam como as APIs do catálogo de dados do AWS Glue lidam com links de recursos de banco de dados e tabelas. Para todas as operações de API do Get*
, somente bancos de dados e tabelas nos quais o chamador tem permissões são retornados. Além disso, ao acessar um banco de dados ou tabela de destino por meio de um link de recurso, você deve ter as permissões do AWS Identity and Access Management (IAM) e Lake Formation no link de destino e no link do recurso. A permissão do Lake Formation exigida nos links de recursos é DESCRIBE
. Para ter mais informações, consulte DESCRIBE.
Operações de API de banco de dados
Operação de API |
Gestão de links de recursos |
CreateDatabase |
Se o banco de dados for um link de recurso, ele cria o link de recurso para o banco de dados de destino designado. |
UpdateDatabase |
Se o banco de dados designado for um link de recurso, ele segue o link e atualiza o banco de dados de destino. Se o link de recurso precisar ser modificado para vincular a um banco de dados diferente, você deverá excluí-lo e criar um novo. |
DeleteDatabase |
Exclua o link do recurso. Isto não exclui o banco de dados vinculado (de destino). |
GetDatabase |
Se o chamador tiver permissões no alvo, ele segue o link para retornar as propriedades do alvo. Caso contrário, ele retornará as propriedades do link. |
GetDatabases |
Retorna uma lista de bancos de dados, incluindo links de recursos. Para cada link de recurso no conjunto de resultados, a operação segue o link para obter as propriedades do link de destino. Você deve especificar ResourceShareType = ALL para ver os bancos de dados compartilhados com sua conta. |
Operações de API de tabela
Operação de API |
Gestão de links de recursos |
CreateTable |
Se o banco de dados for um link de recurso, ele segue o link do banco de dados e cria uma tabela no banco de dados de destino. Se a tabela for um link de recurso, a operação criará o link de recurso no banco de dados designado. Não há suporte para criar um link de recurso de tabela por meio de um link de recurso de banco de dados. |
UpdateTable |
Se a tabela ou o banco de dados designado for um link de recurso, isso atualiza a tabela de destino. Se a tabela e o banco de dados forem links de recursos, a operação falhará. |
DeleteTable |
Se o banco de dados designado for um link de recurso, ele segue o link e exclui a tabela ou o link do recurso da tabela no banco de dados de destino. Se a tabela for um link de recurso, a operação excluirá o link de recurso da tabela no banco de dados designado. A exclusão de um link de recurso de tabela não exclui a tabela de destino. |
BatchDeleteTable |
Igual a DeleteTable . |
GetTable |
Se o banco de dados designado for um link de recurso, ele segue o link do banco de dados e retorna a tabela ou o link do recurso da tabela do banco de dados de destino. Caso contrário, se a tabela for um link de recurso, a operação seguirá o link e retornará as propriedades da tabela de destino. |
GetTables |
Se o banco de dados designado for um link de recurso, ele segue o link do banco de dados e retorna as tabelas e os links de recursos da tabela do banco de dados de destino. Se o banco de dados de destino for um banco de dados compartilhado de outra conta da AWS, a operação retornará somente as tabelas compartilhadas nesse banco de dados. Ele não segue os links de recursos da tabela no banco de dados de destino. Caso contrário, se o banco de dados designado for um banco de dados local (de propriedade), a operação retornará todas as tabelas no banco de dados local e seguirá cada link de recurso da tabela para retornar as propriedades da tabela de destino. |
SearchTables |
Retorna tabelas e links de recursos de tabelas. Ele não segue links para retornar as propriedades da tabela de destino. Você deve especificar ResourceShareType = ALL para ver as tabelas compartilhadas com sua conta. |
GetTableVersion |
Igual a GetTable . |
GetTableVersions |
Igual a GetTable . |
DeleteTableVersion |
Igual a DeleteTable . |
BatchDeleteTableVersion |
Igual a DeleteTable . |
Operações de API de partição
Operação de API |
Gestão de links de recursos |
CreatePartition |
Se o banco de dados designado for um link de recurso, ele segue o link do banco de dados e cria uma partição na tabela designada no banco de dados de destino. Se a tabela for um link de recurso, a operação segue o link do recurso e cria a partição na tabela de destino. A criação de uma partição por meio de um link de recurso de tabela e de um link de recurso de banco de dados não é suportada. |
BatchCreatePartition |
Igual a CreatePartition . |
UpdatePartition |
Se o banco de dados designado for um link de recurso, ele segue o link do banco de dados e atualiza a partição na tabela designada no banco de dados de destino. Se a tabela for um link de recurso, a operação segue o link do recurso e atualiza a partição na tabela de destino. A atualização de uma partição por meio de um link de recurso de tabela e de um link de recurso de banco de dados não é suportada. |
DeletePartition |
Se o banco de dados designado for um link de recurso, ele segue o link do banco de dados e exclui a partição na tabela designada no banco de dados de destino. Se a tabela for um link de recurso, a operação segue o link do recurso e exclui a partição na tabela de destino. A exclusão de uma partição por meio de um link de recurso de tabela e de um link de recurso de banco de dados não é suportada. |
BatchDeletePartition |
Igual a DeletePartition . |
GetPartition |
Se o banco de dados designado for um link de recurso, ele segue o link do banco de dados e retorna as informações da partição da tabela designada. Caso contrário, se a tabela for um link de recurso, a operação seguirá o link e retornará as informações da partição. Se a tabela e o banco de dados forem links de recursos, ele retornará um conjunto de resultados vazio. |
GetPartitions |
Se o banco de dados designado for um link de recurso, ele segue o link do banco de dados e retorna as informações de partição de todas as partições na tabela designada. Caso contrário, se a tabela for um link de recurso, a operação seguirá o link e retornará as informações da partição. Se a tabela e o banco de dados forem links de recursos, ele retornará um conjunto de resultados vazio. |
BatchGetPartition |
Igual a GetPartition . |
Operações de API de perfis definidas pelo usuário
Operação de API |
Gestão de links de recursos |
(Todas as operações de API) |
Se o banco de dados for um link de recurso, ele segue o link do recurso e executa a operação no banco de dados de destino. |