View a markdown version of this page

API d'intégration dans AWS Glue - AWS Glue

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.

API d'intégration dans AWS Glue

Types de données

Structure d’intégration

Décrit une intégration zéro ETL.

Champs
  • SourceArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de la source pour l’intégration.

  • TargetArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de la cible pour l’intégration.

  • Description— UTF-8 chaîne ne dépassant pas 1 000 octets, correspondant àCustom string pattern #17.

    Description de l’intégration.

  • IntegrationName Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Nom unique de l’intégration.

  • IntegrationArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Amazon Resource Name (ARN) de l’intégration.

  • KmsKeyId— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 2 048 octets.

    ARN d’une clé KMS utilisée pour chiffrer le canal.

  • AdditionalEncryptionContext – Tableau de mappage de paires valeur-clé.

    Chaque touche est une UTF-8 chaîne.

    Chaque valeur est une UTF-8 chaîne.

    Ensemble facultatif de paires clé-valeur non secrètes qui contiennent des informations contextuelles supplémentaires pour le chiffrement. Il ne peut être fourni que si KMSKeyId est indiqué.

  • Tags : un tableau d’objets Balise.

    Métadonnée attribuée à la ressource composée d’une liste de paires clé-valeur.

  • Status Obligatoire : UTF-8 chaîne (valeurs valides : CREATING ACTIVE MODIFYING | FAILED | | DELETING | SYNCING |NEEDS_ATTENTION).

    Les statuts possibles sont les suivants :

    • CREATING : l’intégration est en cours de création.

    • ACTIVE : la création de l’intégration a réussi..

    • MODIFYING : l’intégration est en cours de modification.

    • FAILED : la création de l’intégration a échoué.

    • DELETING : l’intégration est supprimée.

    • SYNCING : l’intégration est en cours de synchronisation.

    • NEEDS_ATTENTION : l’intégration requiert votre attention, par exemple pour la synchronisation.

  • CreateTimeobligatoire : horodatage.

    Heure (UTC) de création de l’intégration.

  • IntegrationConfig : un objet IntegrationConfig.

    Propriétés associées à l’intégration.

  • Errors : un tableau d’objets IntegrationError.

    Liste des erreurs associées à l’intégration.

  • DataFilter— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 2 048 octets.

    Sélectionne les tables source pour l’intégration à l’aide de la syntaxe du filtre Maxwell.

IntegrationConfig structure

Propriétés associées à l’intégration.

Champs
  • RefreshInterval— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Spécifie la fréquence à laquelle CDC (Change Data Capture) doit effectuer des extractions ou des chargements incrémentiels. Ce paramètre offre la flexibilité nécessaire pour aligner le taux de rafraîchissement sur vos modèles de mise à jour des données spécifiques, vos considérations relatives à la charge du système et vos objectifs d’optimisation des performances. L’incrément de temps peut être réglé de 15 minutes à 8 640 minutes (six jours).

  • SourceProperties – Tableau de mappage de paires valeur-clé.

    Chaque touche est une UTF-8 chaîne.

    Chaque valeur est une UTF-8 chaîne.

    Une collection de paires clé-valeur qui spécifient des propriétés supplémentaires pour la source d’intégration. Ces propriétés fournissent des options de configuration qui peuvent être utilisées pour personnaliser le comportement de la source ODB lors des opérations d’intégration de données.

  • ContinuousSync : booléen.

    Permet une synchronisation continue pour les extractions de données à la demande depuis des applications SaaS vers AWS des services de données tels qu'Amazon Redshift et. Amazon S3

IntegrationPartition structure

Structure qui décrit la manière dont les données sont partitionnées sur la cible.

Champs
  • FieldName— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Nom du champ utilisé pour partitionner les données sur la cible. Évitez d'utiliser des colonnes qui ont des valeurs uniques pour chaque ligne (par exemple, LastModifiedTimestamp « », SystemModTimeStamp « ») comme colonne de partition. Ces colonnes ne sont pas adaptées au partitionnement, car elles créent un grand nombre de petites partitions, ce qui peut entraîner des problèmes de performances.

  • FunctionSpec— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Spécifie la fonction utilisée pour partitionner les données sur la cible. Les valeurs acceptées pour ce paramètre sont les suivantes :

    • identity : utilise les valeurs source directement sans transformation

    • year : extrait l’année à partir des valeurs d’horodatage (par exemple, 2023)

    • month : extrait le mois à partir des valeurs d’horodatage (par exemple, 2023-01)

    • day : extrait le jour à partir des valeurs d’horodatage (par exemple, 2023-01-15)

    • hour : extrait l’heure à partir des valeurs d’horodatage (par exemple, 2023-01-15-14)

  • ConversionSpec— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Indique le format d’horodatage des données source. Les valeurs valides sont :

    • epoch_sec : horodatage d’époque Unix en secondes

    • epoch_milli : horodatage de l’époque Unix en millisecondes

    • iso : horodatage au format ISO 8601

    Note

    Spécifiez uniquement ConversionSpec lorsque vous utilisez des fonctions de partition basées sur l'horodatage (année, mois, jour ou heure). AWS Glue Zero-ETLutilise ce paramètre pour transformer correctement les données source au format d'horodatage avant le partitionnement.

    N'utilisez pas de colonnes à cardinalité élevée avec la fonction de identity partition. High-cardinality les colonnes incluent :

    • Clés primaires

    • Champs d’horodatage (tels que LastModifiedTimestamp et CreatedDate)

    • System-generated horodatages

    L’utilisation de colonnes à haute cardinalité avec partitionnement des identités crée de nombreuses petites partitions, ce qui peut considérablement dégrader les performances d’ingestion.

IntegrationError structure

Erreur associée à une intégration zéro ETL.

Champs
  • ErrorCode— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Code associé à cette erreur.

  • ErrorMessage— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 2 048 octets.

    Message décrivant l'erreur.

IntegrationFilter structure

Filtre qui peut être utilisé lors de l’invocation d’une demande DescribeIntegrations.

Champs
  • Name— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Nom du filtre.

  • Values— Un tableau de UTF-8 chaînes.

    Une liste de valeurs de filtre.

InboundIntegration structure

Structure pour une intégration qui écrit des données dans une ressource.

Champs
  • SourceArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de la ressource source pour l’intégration.

  • TargetArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de la ressource cible pour l’intégration..

  • IntegrationArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    ARN de l’intégration zéro ETL.

  • Status Obligatoire : UTF-8 chaîne (valeurs valides : CREATING ACTIVE MODIFYING | FAILED | | DELETING | SYNCING |NEEDS_ATTENTION).

    Les statuts possibles sont les suivants :

    • CREATING : l’intégration est en cours de création.

    • ACTIVE : la création de l’intégration a réussi..

    • MODIFYING : l’intégration est en cours de modification.

    • FAILED : la création de l’intégration a échoué.

    • DELETING : l’intégration est supprimée.

    • SYNCING : l’intégration est en cours de synchronisation.

    • NEEDS_ATTENTION : l’intégration requiert votre attention, par exemple pour la synchronisation.

  • CreateTimeobligatoire : horodatage.

    Heure (UTC) de création de l’intégration.

  • IntegrationConfig : un objet IntegrationConfig.

    Propriétés associées à l’intégration.

  • Errors : un tableau d’objets IntegrationError.

    Liste des erreurs associées à l’intégration.

SourceProcessingProperties structure

Propriétés des ressources associées à la source d’intégration.

Champs
  • RoleArn— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Le rôle IAM pour accéder à la AWS Glue connexion.

TargetProcessingProperties structure

Propriétés des ressources associées à la cible d’intégration.

Champs
  • RoleArn— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Le rôle IAM pour accéder à la AWS Glue base de données.

  • KmsArn— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 2 048 octets.

    ARN de la clé KMS utilisée pour le chiffrement.

  • ConnectionName— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    La connexion AWS Glue réseau permettant de configurer le AWS Glue job en cours d'exécution dans le VPC du client.

  • EventBusArn— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 2 048 octets.

    ARN d’un bus d’événements Eventbridge pour recevoir la notification d’état de l’intégration.

SourceTableConfig structure

Propriétés utilisées par l’étape source pour traiter les données de la source.

Champs
  • Fields— Un tableau de UTF-8 chaînes.

    Liste des champs utilisés pour le filtrage au niveau des colonnes. Non prise en charge actuellement.

  • FilterPredicate— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Clause de condition utilisée pour le filtrage au niveau des lignes. Non prise en charge actuellement.

  • PrimaryKey— Un tableau de UTF-8 chaînes.

    Fournissez le jeu de clés primaires pour cette table. Actuellement pris en charge spécifiquement pour les entités SAP EntityOf sur demande. Contactez AWS le support pour mettre cette fonctionnalité à disposition.

  • RecordUpdateField— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Champ d’extraction incrémentielle basée sur l’horodatage. Non prise en charge actuellement.

TargetTableConfig structure

Propriétés utilisées par l’étape cible pour partitionner les données sur la cible.

Champs
  • UnnestSpec— UTF-8 chaîne (valeurs valides : TOPLEVEL | FULL |NOUNNEST).

    Spécifie la manière dont les objets imbriqués sont aplatis par rapport aux éléments de niveau supérieur. Les valeurs valides sont : « TOPLEVEL », « FULL » ou « NOUNNEST ».

  • PartitionSpec : un tableau d’objets IntegrationPartition.

    Détermine la disposition du fichier sur la cible.

  • TargetTableName— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Nom facultatif d’une table cible.

Opérations

CreateIntegration action (Python : create_integration)

Crée une Zero-ETL intégration dans le compte de l'appelant entre deux ressources avec Amazon Resource Names (ARN) : le SourceArn et. TargetArn

Demande
  • IntegrationName Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Nom unique pour une intégration dans AWS Glue.

  • SourceArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de la ressource source pour l’intégration.

  • TargetArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de la ressource cible pour l’intégration..

  • Description— UTF-8 chaîne ne dépassant pas 1 000 octets, correspondant àCustom string pattern #17.

    Description de l’intégration.

  • DataFilter— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 2 048 octets.

    Sélectionne les tables source pour l’intégration à l’aide de la syntaxe du filtre Maxwell.

  • KmsKeyId— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 2 048 octets.

    ARN d’une clé KMS utilisée pour chiffrer le canal.

  • AdditionalEncryptionContext – Tableau de mappage de paires valeur-clé.

    Chaque touche est une UTF-8 chaîne.

    Chaque valeur est une UTF-8 chaîne.

    Ensemble facultatif de paires clé-valeur non secrètes qui contiennent des informations contextuelles supplémentaires pour le chiffrement. Il ne peut être fourni que si KMSKeyId est indiqué.

  • Tags : un tableau d’objets Balise.

    Métadonnée attribuée à la ressource composée d’une liste de paires clé-valeur.

  • IntegrationConfig : un objet IntegrationConfig.

    Paramètres de configuration.

Réponse
  • SourceArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de la ressource source pour l’intégration.

  • TargetArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de la ressource cible pour l’intégration..

  • IntegrationName Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Nom unique pour une intégration dans AWS Glue.

  • Description— UTF-8 chaîne ne dépassant pas 1 000 octets, correspondant àCustom string pattern #17.

    Description de l’intégration.

  • IntegrationArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Amazon Resource Name (ARN) de l’intégration créée.

  • KmsKeyId— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 2 048 octets.

    ARN d’une clé KMS utilisée pour chiffrer le canal.

  • AdditionalEncryptionContext – Tableau de mappage de paires valeur-clé.

    Chaque touche est une UTF-8 chaîne.

    Chaque valeur est une UTF-8 chaîne.

    Ensemble facultatif de paires clé-valeur non secrètes qui contiennent des informations contextuelles supplémentaires pour le chiffrement.

  • Tags : un tableau d’objets Balise.

    Métadonnée attribuée à la ressource composée d’une liste de paires clé-valeur.

  • Status Obligatoire : UTF-8 chaîne (valeurs valides : CREATING ACTIVE MODIFYING | FAILED | | DELETING | SYNCING |NEEDS_ATTENTION).

    État de l’intégration en cours de création.

    Les statuts possibles sont les suivants :

    • CREATING : l’intégration est en cours de création.

    • ACTIVE : la création de l’intégration a réussi..

    • MODIFYING : l’intégration est en cours de modification.

    • FAILED : la création de l’intégration a échoué.

    • DELETING : l’intégration est supprimée.

    • SYNCING : l’intégration est en cours de synchronisation.

    • NEEDS_ATTENTION : l’intégration requiert votre attention, par exemple pour la synchronisation.

  • CreateTimeobligatoire : horodatage.

    Heure (UTC) de création de l’intégration.

  • Errors : un tableau d’objets IntegrationError.

    Liste des erreurs associées à la création de l’intégration.

  • DataFilter— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 2 048 octets.

    Sélectionne les tables source pour l’intégration à l’aide de la syntaxe du filtre Maxwell.

  • IntegrationConfig : un objet IntegrationConfig.

    Paramètres de configuration.

Erreurs
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • IntegrationConflictOperationFault

  • IntegrationQuotaExceededFault

  • KMSKeyNotAccessibleFault

  • EntityNotFoundException

  • InternalServiceException

  • ConflictException

  • ResourceNumberLimitExceededException

  • InvalidInputException

ModifyIntegration action (Python : modify_integration)

Modifie une Zero-ETL intégration dans le compte de l'appelant.

Demande
  • IntegrationIdentifier Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Amazon Resource Name (ARN) de l’intégration.

  • Description— UTF-8 chaîne ne dépassant pas 1 000 octets, correspondant àCustom string pattern #17.

    Description de l’intégration.

  • DataFilter— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 2 048 octets.

    Sélectionne les tables source pour l’intégration à l’aide de la syntaxe du filtre Maxwell.

  • IntegrationConfig : un objet IntegrationConfig.

    Paramètres de configuration pour l’intégration. Actuellement, seul le RefreshInterval peut être modifié.

  • IntegrationName— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Nom unique pour une intégration dans AWS Glue.

Réponse
  • SourceArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de la source pour l’intégration.

  • TargetArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de la cible pour l’intégration.

  • IntegrationName Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Nom unique pour une intégration dans AWS Glue.

  • Description— UTF-8 chaîne ne dépassant pas 1 000 octets, correspondant àCustom string pattern #17.

    Description de l’intégration.

  • IntegrationArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Amazon Resource Name (ARN) de l’intégration.

  • KmsKeyId— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 2 048 octets.

    ARN d’une clé KMS utilisée pour chiffrer le canal.

  • AdditionalEncryptionContext – Tableau de mappage de paires valeur-clé.

    Chaque touche est une UTF-8 chaîne.

    Chaque valeur est une UTF-8 chaîne.

    Ensemble facultatif de paires clé-valeur non secrètes qui contiennent des informations contextuelles supplémentaires pour le chiffrement.

  • Tags : un tableau d’objets Balise.

    Métadonnée attribuée à la ressource composée d’une liste de paires clé-valeur.

  • Status Obligatoire : UTF-8 chaîne (valeurs valides : CREATING ACTIVE MODIFYING | FAILED | | DELETING | SYNCING |NEEDS_ATTENTION).

    État de l’intégration en cours de modification.

    Les statuts possibles sont les suivants :

    • CREATING : l’intégration est en cours de création.

    • ACTIVE : la création de l’intégration a réussi..

    • MODIFYING : l’intégration est en cours de modification.

    • FAILED : la création de l’intégration a échoué.

    • DELETING : l’intégration est supprimée.

    • SYNCING : l’intégration est en cours de synchronisation.

    • NEEDS_ATTENTION : l’intégration requiert votre attention, par exemple pour la synchronisation.

  • CreateTimeobligatoire : horodatage.

    Heure (UTC) de création de l’intégration.

  • Errors : un tableau d’objets IntegrationError.

    Liste des erreurs associées à la modification de l’intégration.

  • DataFilter— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 2 048 octets.

    Sélectionne les tables source pour l’intégration à l’aide de la syntaxe du filtre Maxwell.

  • IntegrationConfig : un objet IntegrationConfig.

    Paramètres de configuration mis à jour pour l’intégration.

Erreurs
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • IntegrationNotFoundFault

  • IntegrationConflictOperationFault

  • InvalidIntegrationStateFault

  • EntityNotFoundException

  • InternalServiceException

  • ConflictException

  • InvalidStateException

  • InvalidInputException

DescribeIntegrations action (Python : describe_integrations)

L’API est utilisée pour récupérer une liste d’intégrations.

Demande
  • IntegrationIdentifier— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Amazon Resource Name (ARN) de l’intégration.

  • Marker— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Valeur qui indique le point de départ de la prochaine série d’enregistrements de réponses dans une demande ultérieure.

  • MaxRecords : nombre (entier).

    Nombre total d’éléments à renvoyer dans la sortie.

  • Filters : un tableau d’objets IntegrationFilter.

    Liste de clés et de valeurs, pour filtrer les résultats. Les clés prises en charge sont « Status », IntegrationName « et SourceArn ». IntegrationName est limité à une seule valeur.

Réponse
  • Integrations : un tableau d’objets Integration.

    Liste des intégrations zéro ETL.

  • Marker— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Valeur qui indique le point de départ de la prochaine série d’enregistrements de réponses dans une demande ultérieure.

Erreurs
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • IntegrationNotFoundFault

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

DeleteIntegration action (Python : delete_integration)

Supprime l' Zero-ETL intégration spécifiée.

Demande
  • IntegrationIdentifier Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Amazon Resource Name (ARN) de l’intégration.

Réponse
  • SourceArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de la source pour l’intégration.

  • TargetArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de la cible pour l’intégration.

  • IntegrationName Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Nom unique pour une intégration dans AWS Glue.

  • Description— UTF-8 chaîne ne dépassant pas 1 000 octets, correspondant àCustom string pattern #17.

    Description de l’intégration.

  • IntegrationArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Amazon Resource Name (ARN) de l’intégration.

  • KmsKeyId— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 2 048 octets.

    ARN d’une clé KMS utilisée pour chiffrer le canal.

  • AdditionalEncryptionContext – Tableau de mappage de paires valeur-clé.

    Chaque touche est une UTF-8 chaîne.

    Chaque valeur est une UTF-8 chaîne.

    Ensemble facultatif de paires clé-valeur non secrètes qui contiennent des informations contextuelles supplémentaires pour le chiffrement.

  • Tags : un tableau d’objets Balise.

    Métadonnée attribuée à la ressource composée d’une liste de paires clé-valeur.

  • Status Obligatoire : UTF-8 chaîne (valeurs valides : CREATING ACTIVE MODIFYING | FAILED | | DELETING | SYNCING |NEEDS_ATTENTION).

    État de l’intégration en cours de suppression.

    Les statuts possibles sont les suivants :

    • CREATING : l’intégration est en cours de création.

    • ACTIVE : la création de l’intégration a réussi..

    • MODIFYING : l’intégration est en cours de modification.

    • FAILED : la création de l’intégration a échoué.

    • DELETING : l’intégration est supprimée.

    • SYNCING : l’intégration est en cours de synchronisation.

    • NEEDS_ATTENTION : l’intégration requiert votre attention, par exemple pour la synchronisation.

  • CreateTimeobligatoire : horodatage.

    Heure (UTC) de création de l’intégration.

  • Errors : un tableau d’objets IntegrationError.

    Liste des erreurs associées à l’intégration.

  • DataFilter— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 2 048 octets.

    Sélectionne les tables source pour l’intégration à l’aide de la syntaxe du filtre Maxwell.

Erreurs
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • IntegrationNotFoundFault

  • IntegrationConflictOperationFault

  • InvalidIntegrationStateFault

  • EntityNotFoundException

  • InternalServiceException

  • ConflictException

  • InvalidStateException

  • InvalidInputException

DescribeInboundIntegrations action (Python : describe_inbound_integrations)

Renvoie une liste des intégrations entrantes pour l’intégration spécifiée.

Demande
  • IntegrationArn— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Amazon Resource Name (ARN) de l’intégration.

  • Marker— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Jeton permettant de spécifier où commencer la pagination. Il s’agit du marqueur provenant d’une réponse tronquée précédemment.

  • MaxRecords : nombre (entier).

    Nombre total d’éléments à renvoyer dans la sortie.

  • TargetArn— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    Amazon Resource Name (ARN) de la ressource cible dans l’intégration.

Réponse
  • InboundIntegrations : un tableau d’objets InboundIntegration.

    Liste des intégrations entrantes.

  • Marker— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Valeur qui indique le point de départ de la prochaine série d’enregistrements de réponses dans une demande ultérieure.

Erreurs
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • IntegrationNotFoundFault

  • TargetResourceNotFound

  • OperationNotSupportedException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

CreateIntegrationTableProperties action (Python : create_integration_table_properties)

Cette API est utilisée pour fournir des propriétés de remplacement facultatives pour les tables qui doivent être répliquées. Ces propriétés peuvent inclure des propriétés de filtrage et de partitionnement pour les tables source et cible. Pour définir à la fois les propriétés source et cible, la même API doit être invoquée avec l'ARN de AWS Glue connexion comme ResourceArn avec et l'ARN de la AWS Glue base de données comme ResourceArn avecSourceTableConfig, TargetTableConfig respectivement.

Demande
  • ResourceArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    Amazon Resource Name (ARN) de la table cible pour laquelle vous souhaitez créer les propriétés de la table d’intégration. Actuellement, cette API prend uniquement en charge la création de propriétés de table d'intégration pour les tables cibles, et l'ARN fourni doit être l'ARN de la table cible dans le catalogue de AWS Glue données. La prise en charge de la création de propriétés de table d’intégration pour les connexions source (à l’aide de l’ARN de connexion) n’est pas encore mise en œuvre et sera ajoutée dans une future version.

  • TableName Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Nom de la table à répliquer.

  • SourceTableConfig – Un objet SourceTableConfig.

    Structure pour la configuration de table source. Consultez la structure SourceTableConfig pour voir la liste des propriétés source prises en charge.

  • TargetTableConfig – Un objet TargetTableConfig.

    Structure pour la configuration de table cible.

Réponse
  • Paramètres d’absence de réponse.

Erreurs
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

UpdateIntegrationTableProperties action (Python : update_integration_table_properties)

Cette API est utilisée pour fournir des propriétés de remplacement facultatives pour les tables qui doivent être répliquées. Ces propriétés peuvent inclure des propriétés de filtrage et de partitionnement pour les tables source et cible. Pour définir à la fois les propriétés source et cible, la même API doit être invoquée avec l'ARN de AWS Glue connexion comme ResourceArn avec et l'ARN de la AWS Glue base de données comme ResourceArn avecSourceTableConfig, TargetTableConfig respectivement.

Le remplacement sera reflété dans toutes les intégrations utilisant le même ResourceArn et la même table source.

Demande
  • ResourceArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de connexion de la source ou ARN de base de données de la cible.

  • TableName Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Nom de la table à répliquer.

  • SourceTableConfig – Un objet SourceTableConfig.

    Structure pour la configuration de table source.

  • TargetTableConfig – Un objet TargetTableConfig.

    Structure pour la configuration de table cible.

Réponse
  • Paramètres d’absence de réponse.

Erreurs
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

GetIntegrationTableProperties action (Python : get_integration_table_properties)

Cette API est utilisée pour extraire des propriétés de remplacement facultatives pour les tables qui doivent être répliquées. Ces propriétés peuvent inclure des propriétés de filtrage et de partition pour les tables source et cible.

Demande
  • ResourceArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    Amazon Resource Name (ARN) de la table cible pour laquelle vous souhaitez récupérer les propriétés de la table d’intégration. Actuellement, cette API ne prend en charge que la récupération des propriétés des tables cibles, et l'ARN fourni doit être l'ARN de la table cible dans le catalogue de AWS Glue données. La prise en charge de la récupération de propriétés de table d’intégration pour les connexions source (à l’aide de l’ARN de connexion) n’est pas encore mise en œuvre et sera ajoutée dans une future version.

  • TableName Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Nom de la table à répliquer.

Réponse
  • ResourceArn— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    Amazon Resource Name (ARN) de la table cible pour laquelle vous souhaitez récupérer les propriétés de la table d’intégration. Actuellement, cette API ne prend en charge que la récupération des propriétés des tables cibles, et l'ARN fourni doit être l'ARN de la table cible dans le catalogue de AWS Glue données. La prise en charge de la récupération de propriétés de table d’intégration pour les connexions source (à l’aide de l’ARN de connexion) n’est pas encore mise en œuvre et sera ajoutée dans une future version.

  • TableName— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Nom de la table à répliquer.

  • SourceTableConfig – Un objet SourceTableConfig.

    Structure pour la configuration de table source.

  • TargetTableConfig – Un objet TargetTableConfig.

    Structure pour la configuration de table cible.

Erreurs
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

DeleteIntegrationTableProperties action (Python : delete_integration_table_properties)

Supprime les propriétés de table créées pour les tables devant être répliquées.

Demande
  • ResourceArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de connexion de la source ou ARN de base de données de la cible.

  • TableName Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 128 octets.

    Nom de la table à répliquer.

Réponse
  • Paramètres d’absence de réponse.

Erreurs
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

CreateIntegrationResourceProperty action (Python : create_integration_resource_property)

Cette API peut être utilisée pour configurer l'ARN ResourceProperty de la AWS Glue connexion (pour la source) ou de la AWS Glue base de données (pour la cible). Ces propriétés peuvent inclure le rôle permettant d’accéder à la connexion ou à la base de données. Pour définir à la fois les propriétés source et cible, la même API doit être invoquée avec l'ARN de AWS Glue connexion comme ResourceArn avec SourceProcessingProperties et l'ARN AWS Glue de la base de données comme ResourceArn avec TargetProcessingProperties respectivement.

Demande
  • ResourceArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de connexion de la source ou ARN de base de données de la cible.

  • SourceProcessingProperties – Un objet SourceProcessingProperties.

    Propriétés des ressources associées à la source d’intégration.

  • TargetProcessingProperties – Un objet TargetProcessingProperties.

    Propriétés des ressources associées à la cible d’intégration.

  • Tags : un tableau d’objets Balise.

    Métadonnée attribuée à la ressource composée d’une liste de paires clé-valeur.

Réponse
  • ResourceArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de connexion de la source ou ARN de base de données de la cible.

  • ResourcePropertyArn— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    L'ARN de ressource créé via cette API de création. <region><account_id>Le format est quelque chose comme arn:aws:glue : ::integrationresourceproperty/*

  • SourceProcessingProperties – Un objet SourceProcessingProperties.

    Propriétés des ressources associées à la source d’intégration.

  • TargetProcessingProperties – Un objet TargetProcessingProperties.

    Propriétés des ressources associées à la cible d’intégration.

Erreurs
  • ValidationException

  • AccessDeniedException

  • ConflictException

  • InternalServerException

  • ResourceNotFoundException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

UpdateIntegrationResourceProperty action (Python : update_integration_resource_property)

Cette API peut être utilisée pour mettre à jour l'ARN ResourceProperty de la AWS Glue connexion (pour la source) ou AWS Glue de la base de données (pour la cible). Ces propriétés peuvent inclure le rôle permettant d’accéder à la connexion ou à la base de données. Comme la même ressource peut être utilisée dans plusieurs intégrations, la mise à jour des propriétés des ressources aura un impact sur toutes les intégrations qui l’utilisent.

Demande
  • ResourceArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de connexion de la source ou ARN de base de données de la cible.

  • SourceProcessingProperties – Un objet SourceProcessingProperties.

    Propriétés des ressources associées à la source d’intégration.

  • TargetProcessingProperties – Un objet TargetProcessingProperties.

    Propriétés des ressources associées à la cible d’intégration.

Réponse
  • ResourceArn— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de connexion de la source ou ARN de base de données de la cible.

  • ResourcePropertyArn— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    L'ARN de ressource créé via cette API de création. <region><account_id>Le format est quelque chose comme arn:aws:glue : ::integrationresourceproperty/*

  • SourceProcessingProperties – Un objet SourceProcessingProperties.

    Propriétés des ressources associées à la source d’intégration.

  • TargetProcessingProperties – Un objet TargetProcessingProperties.

    Propriétés des ressources associées à la cible d’intégration.

Erreurs
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • ResourceNotFoundException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

GetIntegrationResourceProperty action (Python : get_integration_resource_property)

Cette API est utilisée pour récupérer l'ARN ResourceProperty de la AWS Glue connexion (pour la source) ou de la AWS Glue base de données (pour la cible)

Demande
  • ResourceArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de connexion de la source ou ARN de base de données de la cible.

Réponse
  • ResourceArn— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    ARN de connexion de la source ou ARN de base de données de la cible.

  • ResourcePropertyArn— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 512 octets.

    L'ARN de ressource créé via cette API de création. <region><account_id>Le format est quelque chose comme arn:aws:glue : ::integrationresourceproperty/*

  • SourceProcessingProperties – Un objet SourceProcessingProperties.

    Propriétés des ressources associées à la source d’intégration.

  • TargetProcessingProperties – Un objet TargetProcessingProperties.

    Propriétés des ressources associées à la cible d’intégration.

Erreurs
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • ResourceNotFoundException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

UntagResource action (Python : untag_resource)

Supprime les balises spécifiées d’une ressource d’intégration.

Demande
  • ResourceArn Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 10240 octets, correspondant à. Custom string pattern #47

    Amazon Resource Name (ARN) de la ressource d’intégration.

  • TagsToRemove Obligatoire : un tableau de UTF-8 chaînes, pas plus de 50 chaînes.

    Liste des balises de métadonnés à supprimer de la ressource.

Réponse
  • Paramètres d’absence de réponse.

Erreurs
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

ListTagsForResource action (Python : list_tags_for_resource)

Répertorie les balises de métadonnées attribuées à la ressource spécifiée.

Demande
  • ResourceARN Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 10240 octets, correspondant à. Custom string pattern #47

    ARN de ressource pour la ressource.

Réponse
  • Tags – Un tableau d'objets Balise, 10 structures au maximum.

    Une liste de balises.

Erreurs
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

Exceptions

ResourceNotFoundException structure

La ressource est introuvable.

Champs
  • Message— UTF-8 ficelle.

    Un message décrivant le problème.

InternalServerException structure

Une erreur interne du serveur s’est produite.

Champs
  • Message— UTF-8 ficelle.

    Un message décrivant le problème.

IntegrationAlreadyExistsFault structure

L’intégration spécifiée existe déjà.

Champs
  • Message— UTF-8 ficelle.

    Un message décrivant le problème.

IntegrationConflictOperationFault structure

L’opération demandée est en conflit avec une autre opération.

Champs
  • Message— UTF-8 ficelle.

    Un message décrivant le problème.

IntegrationQuotaExceededFault structure

Les données traitées dans le cadre de votre intégration ont dépassé votre quota.

Champs
  • Message— UTF-8 ficelle.

    Un message décrivant le problème.

KMSKeyNotAccessibleFault structure

La clé KMS spécifiée n’est pas accessible.

Champs
  • Message— UTF-8 ficelle.

    Un message décrivant le problème.

IntegrationNotFoundFault structure

L’intégration spécifiée est introuvable.

Champs
  • Message— UTF-8 ficelle.

    Un message décrivant le problème.

TargetResourceNotFound structure

La ressource cible est introuvable.

Champs
  • Message— UTF-8 ficelle.

    Un message décrivant le problème.

InvalidIntegrationStateFault structure

L’intégration est dans un état non valide.

Champs
  • Message— UTF-8 ficelle.

    Un message décrivant le problème.