Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Gestion des liens de ressources dans AWS Glue
APIs
Les tableaux suivants expliquent comment AWS Glue Le catalogue de données APIs gère les liens vers les ressources des bases de données et des tables. Pour toutes les Get*
API opérations, seules les bases de données et les tables sur lesquelles l'appelant est autorisé sont renvoyées. En outre, lorsque vous accédez à une base de données ou à une table cible via un lien de ressource, vous devez disposer des autorisations AWS Identity and Access Management (IAM) et Lake Formation sur la cible et sur le lien de ressource. L'autorisation de Lake Formation requise pour les liens de ressources estDESCRIBE
. Pour de plus amples informations, veuillez consulter DESCRIBE.
APIOpérations sur les bases
APIopération |
Gestion des liens vers les ressources |
CreateDatabase |
Si la base de données est un lien de ressource, crée le lien de ressource vers la base de données cible désignée. |
UpdateDatabase |
Si la base de données désignée est un lien de ressource, suivez le lien et mettez à jour la base de données cible. Si le lien de ressource doit être modifié pour être lié à une autre base de données, vous devez le supprimer et en créer une nouvelle. |
DeleteDatabase |
Supprime le lien vers la ressource. Il ne supprime pas la base de données liée (cible). |
GetDatabase |
Si l'appelant dispose d'autorisations sur la cible, suivez le lien pour renvoyer les propriétés de la cible. Dans le cas contraire, elle renvoie les propriétés du lien. |
GetDatabases |
Renvoie une liste de bases de données, y compris des liens vers des ressources. Pour chaque lien de ressource du jeu de résultats, l'opération suit le lien pour obtenir les propriétés de la cible du lien. Vous devez spécifier ResourceShareType = ALL pour voir les bases de données partagées avec votre compte. |
APIOpérations sur les tables
APIopération |
Gestion des liens vers les ressources |
CreateTable |
Si la base de données est un lien de ressource, suit le lien de base de données et crée une table dans la base de données cible. Si la table est un lien de ressource, l'opération crée le lien de ressource dans la base de données désignée. La création d'un lien vers une ressource de table via un lien vers une ressource de base de données n'est pas prise en charge. |
UpdateTable |
Si la table ou la base de données désignée est un lien de ressource, met à jour la table cible. Si la table et la base de données sont toutes deux des liens de ressources, l'opération échoue. |
DeleteTable |
Si la base de données désignée est un lien de ressource, suit le lien et supprime le lien de ressource de table ou de table dans la base de données cible. Si la table est un lien de ressource, l'opération supprime le lien de ressource de table dans la base de données désignée. La suppression d'un lien vers une ressource de table ne supprime pas la table cible. |
BatchDeleteTable |
Identique à DeleteTable . |
GetTable |
Si la base de données désignée est un lien de ressource, suit le lien de base de données et renvoie le lien de ressource de table ou de table depuis la base de données cible. Sinon, si la table est un lien vers une ressource, l'opération suit le lien et renvoie les propriétés de la table cible. |
GetTables |
Si la base de données désignée est un lien de ressource, suit le lien de base de données et renvoie les tables et les liens de ressources de table depuis la base de données cible. Si la base de données cible est une base de données partagée provenant d'un autre AWS compte, l'opération renvoie uniquement les tables partagées de cette base de données. Il ne suit pas les liens vers les ressources de la table dans la base de données cible. Sinon, si la base de données désignée est une base de données locale (détenue), l'opération renvoie toutes les tables de la base de données locale et suit chaque lien de ressource de table pour renvoyer les propriétés de la table cible. |
SearchTables |
Renvoie les tables et les liens vers les ressources des tables. Il ne suit pas les liens pour renvoyer les propriétés de la table cible. Vous devez spécifier ResourceShareType = ALL pour voir les tables partagées avec votre compte. |
GetTableVersion |
Identique à GetTable . |
GetTableVersions |
Identique à GetTable . |
DeleteTableVersion |
Identique à DeleteTable . |
BatchDeleteTableVersion |
Identique à DeleteTable . |
APIOpérations de partition
APIopération |
Gestion des liens vers les ressources |
CreatePartition |
Si la base de données désignée est un lien de ressource, suit le lien de base de données et crée une partition dans la table désignée de la base de données cible. Si la table est un lien de ressource, l'opération suit le lien de ressource et crée la partition dans la table cible. La création d'une partition via un lien de ressource de table et un lien de ressource de base de données n'est pas prise en charge. |
BatchCreatePartition |
Identique à CreatePartition . |
UpdatePartition |
Si la base de données désignée est un lien de ressource, suit le lien de base de données et met à jour la partition dans la table désignée dans la base de données cible. Si la table est un lien de ressource, l'opération suit le lien de ressource et met à jour la partition dans la table cible. La mise à jour d'une partition via un lien de ressource de table et un lien de ressource de base de données n'est pas prise en charge. |
DeletePartition |
Si la base de données désignée est un lien de ressource, suit le lien de base de données et supprime la partition dans la table désignée dans la base de données cible. Si la table est un lien de ressource, l'opération suit le lien de ressource et supprime la partition dans la table cible. La suppression d'une partition via un lien de ressource de table et un lien de ressource de base de données n'est pas prise en charge. |
BatchDeletePartition |
Identique à DeletePartition . |
GetPartition |
Si la base de données désignée est un lien de ressource, suit le lien de base de données et renvoie les informations de partition à partir de la table désignée. Sinon, si la table est un lien de ressource, l'opération suit le lien et renvoie les informations de partition. Si la table et la base de données sont toutes deux des liens de ressources, elles renvoient un jeu de résultats vide. |
GetPartitions |
Si la base de données désignée est un lien de ressource, suit le lien de base de données et renvoie les informations de partition pour toutes les partitions de la table désignée. Sinon, si la table est un lien de ressource, l'opération suit le lien et renvoie les informations de partition. Si la table et la base de données sont toutes deux des liens de ressources, elles renvoient un jeu de résultats vide. |
BatchGetPartition |
Identique à GetPartition . |
Opérations de fonctions API définies par l'utilisateur
APIopération |
Gestion des liens vers les ressources |
(Toutes les API opérations) |
Si la base de données est un lien de ressource, suit le lien de ressource et exécute l'opération sur la base de données cible. |