View a markdown version of this page

API di integrazione in AWS Glue - AWS Aderenza

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

API di integrazione in AWS Glue

Tipi di dati

Struttura di integrazione

Descrive un'integrazione Zero-ETL.

Campi
  • SourceArn UTF-8 Obbligatoria: stringa lunga non meno di 1 o più di 512 byte.

    L'ARN dell'origine dell'integrazione.

  • TargetArn UTF-8 Obbligatoria: stringa di lunghezza non inferiore a 1 o superiore a 512 byte.

    L'ARN della destinazione dell'integrazione.

  • Description— UTF-8 stringa, lunga non più di 1000 byte, corrispondente a. Custom string pattern #17

    Una descrizione dell'integrazione.

  • IntegrationName UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 128 byte.

    Un nome univoco dell'integrazione.

  • IntegrationArn UTF-8 Obbligatoria: stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Il nome della risorsa Amazon (ARN) dell'integrazione.

  • KmsKeyId— UTF-8 stringa, lunga non meno di 1 o più di 2048 byte.

    L'ARN di una chiave KMS utilizzata per crittografare il canale.

  • AdditionalEncryptionContext: una matrice della mappa di coppie chiave-valore.

    Ogni chiave è una UTF-8 stringa.

    Ogni valore è una UTF-8 stringa.

    Un set facoltativo di coppie chiave-valore che contengono ulteriori informazioni contestuali per la crittografia. Può essere indicato solo se viene fornito KMSKeyId.

  • Tags: una matrice di oggetti Tag.

    I metadati assegnati alla risorsa costituita da un elenco di coppie chiave-valore.

  • Status Obbligatorio: UTF-8 stringa (valori validi: CREATING ACTIVE MODIFYING | FAILED | DELETING | | SYNCING |NEEDS_ATTENTION).

    I possibili stati sono:

    • CREATING: l'integrazione è in fase di creazione.

    • ACTIVE: la creazione dell'integrazione ha esito positivo.

    • MODIFYING: l'integrazione è in fase di modifica.

    • FAILED: la creazione dell'integrazione ha esito negativo.

    • DELETING: l'integrazione viene eliminata.

    • SYNCING: l'integrazione è in fase di sincronizzazione.

    • NEEDS_ATTENTION: l'integrazione richiede attenzione, ad esempio per la sincronizzazione.

  • CreateTime - obbligatorio: timestamp.

    L'ora di creazione dell'integrazione in fuso orario UTC.

  • IntegrationConfig: un oggetto IntegrationConfig.

    Proprietà associate all'integrazione.

  • Errors: una matrice di oggetti IntegrationError.

    Un elenco di errori associati all'integrazione.

  • DataFilter— UTF-8 stringa, lunga non meno di 1 o più di 2048 byte.

    Seleziona le tabelle di origine per l'integrazione con la sintassi del filtro Maxwell.

IntegrationConfig struttura

Proprietà associate all'integrazione.

Campi
  • RefreshInterval— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Specifica la frequenza con cui avvengono le estrazioni dell'acquisizione dei dati di modifica (CDC) o si verificano carichi incrementali. Questo parametro offre la flessibilità necessaria per allineare la frequenza di aggiornamento ai modelli di aggiornamento dei dati specifici, alle considerazioni sul carico del sistema e agli obiettivi di ottimizzazione delle prestazioni. L'incremento di tempo può essere impostato su un valore da 15 minuti a 8640 minuti (sei giorni).

  • SourceProperties: una matrice della mappa di coppie chiave-valore.

    Ogni chiave è una UTF-8 stringa.

    Ogni valore è una UTF-8 stringa.

    Una raccolta di coppie chiave-valore che specificano proprietà aggiuntive dell'origine dell'integrazione. Queste proprietà forniscono opzioni di configurazione che possono essere utilizzate per personalizzare il comportamento dell'origine ODB durante le operazioni di integrazione dei dati.

  • ContinuousSync: booleano.

    Consente la sincronizzazione continua per le estrazioni di dati su richiesta da applicazioni SaaS a servizi di AWS dati come Amazon Redshift e. Amazon S3

IntegrationPartition struttura

Una struttura che descrive come vengono partizionati i dati nella destinazione.

Campi
  • FieldName— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Il nome del campo utilizzato per partizionare i dati nella destinazione. Evitare di utilizzare colonne con valori univoci per ogni riga (ad esempio, LastModifiedTimestamp '', SystemModTimeStamp ') come colonna di partizione. Queste colonne non sono adatte al partizionamento poiché creano un numero elevato di piccole partizioni; ciò può causare problemi di prestazioni.

  • FunctionSpec— UTF-8 stringa lunga non meno di 1 o più di 128 byte.

    Specifica la funzione utilizzata per partizionare i dati nella destinazione. I valori accettati per questo parametro sono:

    • identity: utilizza i valori di origine direttamente, senza trasformazione

    • year: estrae l'anno dai valori di timestamp (ad es., 2023)

    • month: estrae il mese dai valori di timestamp (ad es., 2023-01)

    • day: estrae il giorno dai valori di timestamp (ad es., 2023-01-15)

    • hour: estrae l'ora dai valori di timestamp (ad es., 2023-01-15-14)

  • ConversionSpec— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Specifica il formato di timestamp dei dati di origine. I valori validi sono:

    • epoch_sec: timestamp epoch Unix in secondi

    • epoch_milli: timestamp epoch Unix in millisecondi

    • iso: timestamp in formato ISO 8601

    Nota

    Specifica solo ConversionSpec quando si utilizzano funzioni di partizione basate sul timestamp (anno, mese, giorno o ora). AWS Glue Zero-ETLutilizza questo parametro per trasformare correttamente i dati di origine in formato timestamp prima del partizionamento.

    Non utilizzare colonne ad alta cardinalità con la funzione di partizione. identity High-cardinality le colonne includono:

    • Chiavi primarie

    • Campi timestamp (come LastModifiedTimestamp, CreatedDate)

    • System-generated timestamp

    L'utilizzo di colonne ad alta cardinalità con il partizionamento per identità crea tante piccole partizioni, che possono ridurre significativamente le prestazioni di acquisizione.

IntegrationError struttura

Un errore associato a un'integrazione Zero-ETL.

Campi
  • ErrorCode— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Il codice associato a questo errore.

  • ErrorMessage— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 2048 byte.

    Messaggio che descrive l'errore.

IntegrationFilter struttura

Un filtro che può essere utilizzato quando si invoca una richiesta DescribeIntegrations.

Campi
  • Name— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Il nome del filtro.

  • Values— Una serie di UTF-8 stringhe.

    Un elenco di valori di filtro.

InboundIntegration struttura

Una struttura di un'integrazione che scrive dati in una risorsa.

Campi
  • SourceArn UTF-8 Obbligatoria: stringa lunga non meno di 1 o più di 512 byte.

    L'ARN della risorsa di origine dell'integrazione.

  • TargetArn UTF-8 Obbligatoria: stringa di lunghezza non inferiore a 1 o superiore a 512 byte.

    L'ARN della risorsa di destinazione dell'integrazione.

  • IntegrationArn UTF-8 Obbligatoria: stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    L'ARN dell'integrazione Zero-ETL.

  • Status Obbligatorio: UTF-8 stringa (valori validi: CREATING ACTIVE | MODIFYING | FAILED | DELETING | SYNCING |NEEDS_ATTENTION).

    I possibili stati sono:

    • CREATING: l'integrazione è in fase di creazione.

    • ACTIVE: la creazione dell'integrazione ha esito positivo.

    • MODIFYING: l'integrazione è in fase di modifica.

    • FAILED: la creazione dell'integrazione ha esito negativo.

    • DELETING: l'integrazione viene eliminata.

    • SYNCING: l'integrazione è in fase di sincronizzazione.

    • NEEDS_ATTENTION: l'integrazione richiede attenzione, ad esempio per la sincronizzazione.

  • CreateTime - obbligatorio: timestamp.

    L'ora di creazione dell'integrazione in fuso orario UTC.

  • IntegrationConfig: un oggetto IntegrationConfig.

    Proprietà associate all'integrazione.

  • Errors: una matrice di oggetti IntegrationError.

    Un elenco di errori associati all'integrazione.

SourceProcessingProperties struttura

Le proprietà della risorsa associate all'origine dell'integrazione.

Campi
  • RoleArn— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Il ruolo IAM per accedere alla AWS Glue connessione.

TargetProcessingProperties struttura

Le proprietà della risorsa associate alla destinazione dell'integrazione.

Campi
  • RoleArn— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Il ruolo IAM per accedere al AWS Glue database.

  • KmsArn— UTF-8 stringa, lunga non meno di 1 o più di 2048 byte.

    L'ARN della chiave KMS utilizzata per la crittografia.

  • ConnectionName— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    La connessione AWS Glue di rete per configurare il AWS Glue processo in esecuzione nel VPC del cliente.

  • EventBusArn— UTF-8 stringa lunga non meno di 1 o più di 2048 byte.

    L'ARN di un router di eventi Eventbridge per ricevere la notifica dello stato dell'integrazione.

SourceTableConfig struttura

Proprietà utilizzate dal leg di origine per elaborare i dati dall'origine.

Campi
  • Fields— Una serie di UTF-8 stringhe.

    Un elenco di campi utilizzati per il filtraggio a livello di colonna. Attualmente non è supportata.

  • FilterPredicate— UTF-8 stringa lunga non meno di 1 o più di 128 byte.

    Una clausola di condizione utilizzata per il filtraggio a livello di riga. Attualmente non è supportata.

  • PrimaryKey— Una serie di UTF-8 stringhe.

    Fornire il set di chiavi primarie per questa tabella. Al momento supportato specificamente per le entità SAP EntityOf su richiesta. Contatta l' AWS assistenza per rendere disponibile questa funzionalità.

  • RecordUpdateField— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Campo di acquisizione incrementale basata su timestamp. Attualmente non è supportata.

TargetTableConfig struttura

Proprietà utilizzate dal leg di destinazione per partizionare i dati nella destinazione.

Campi
  • UnnestSpec— UTF-8 stringa (valori validi: TOPLEVEL | FULL |NOUNNEST).

    Specifica in che modo gli oggetti annidati vengono ridotti a oggetti di primo livello. I valori validi sono: “TOPLEVEL”, “FULL” o “NOUNNEST”.

  • PartitionSpec: una matrice di oggetti IntegrationPartition.

    Determina il layout del file nella destinazione.

  • TargetTableName— UTF-8 stringa, lunga non meno di 1 o più di 128 byte.

    Il nome facoltativo di una tabella di destinazione.

Operazioni

CreateIntegration azione (Python: create_integration)

Crea un' Zero-ETL integrazione nell'account del chiamante tra due risorse con Amazon Resource Names (ARN): e. SourceArn TargetArn

Richiesta
  • IntegrationName UTF-8 Obbligatoria: stringa lunga non meno di 1 o più di 128 byte.

    Un nome univoco per un'integrazione in AWS Glue.

  • SourceArn UTF-8 Obbligatoria: stringa di lunghezza non inferiore a 1 o superiore a 512 byte.

    L'ARN della risorsa di origine dell'integrazione.

  • TargetArn UTF-8 Obbligatoria: stringa di lunghezza non inferiore a 1 o superiore a 512 byte.

    L'ARN della risorsa di destinazione dell'integrazione.

  • Description— UTF-8 stringa, lunga non più di 1000 byte, corrispondente a. Custom string pattern #17

    Una descrizione dell'integrazione.

  • DataFilter— UTF-8 stringa, lunga non meno di 1 o più di 2048 byte.

    Seleziona le tabelle di origine per l'integrazione con la sintassi del filtro Maxwell.

  • KmsKeyId— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 2048 byte.

    L'ARN di una chiave KMS utilizzata per crittografare il canale.

  • AdditionalEncryptionContext: una matrice della mappa di coppie chiave-valore.

    Ogni chiave è una UTF-8 stringa.

    Ogni valore è una UTF-8 stringa.

    Un set facoltativo di coppie chiave-valore che contengono ulteriori informazioni contestuali per la crittografia. Può essere indicato solo se viene fornito KMSKeyId.

  • Tags: una matrice di oggetti Tag.

    I metadati assegnati alla risorsa costituita da un elenco di coppie chiave-valore.

  • IntegrationConfig: un oggetto IntegrationConfig.

    Le impostazioni di configurazione.

Risposta
  • SourceArn UTF-8 Obbligatoria: stringa lunga non meno di 1 o più di 512 byte.

    L'ARN della risorsa di origine dell'integrazione.

  • TargetArn UTF-8 Obbligatoria: stringa di lunghezza non inferiore a 1 o superiore a 512 byte.

    L'ARN della risorsa di destinazione dell'integrazione.

  • IntegrationName UTF-8 Obbligatoria: stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Un nome univoco per un'integrazione in AWS Glue.

  • Description— UTF-8 stringa, lunga non più di 1000 byte, corrispondente a. Custom string pattern #17

    Una descrizione dell'integrazione.

  • IntegrationArn UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 128 byte.

    Il nome della risorsa Amazon (ARN) dell'integrazione creata.

  • KmsKeyId— UTF-8 stringa, lunga non meno di 1 o più di 2048 byte.

    L'ARN di una chiave KMS utilizzata per crittografare il canale.

  • AdditionalEncryptionContext: una matrice della mappa di coppie chiave-valore.

    Ogni chiave è una UTF-8 stringa.

    Ogni valore è una UTF-8 stringa.

    Un set facoltativo di coppie chiave-valore che contengono ulteriori informazioni contestuali per la crittografia.

  • Tags: una matrice di oggetti Tag.

    I metadati assegnati alla risorsa costituita da un elenco di coppie chiave-valore.

  • Status Obbligatorio: UTF-8 stringa (valori validi: CREATING ACTIVE MODIFYING | FAILED | DELETING | | SYNCING |NEEDS_ATTENTION).

    Lo stato dell'integrazione in fase di creazione.

    I possibili stati sono:

    • CREATING: l'integrazione è in fase di creazione.

    • ACTIVE: la creazione dell'integrazione ha esito positivo.

    • MODIFYING: l'integrazione è in fase di modifica.

    • FAILED: la creazione dell'integrazione ha esito negativo.

    • DELETING: l'integrazione viene eliminata.

    • SYNCING: l'integrazione è in fase di sincronizzazione.

    • NEEDS_ATTENTION: l'integrazione richiede attenzione, ad esempio per la sincronizzazione.

  • CreateTime - obbligatorio: timestamp.

    L'ora di creazione dell'integrazione, in fuso orario UTC.

  • Errors: una matrice di oggetti IntegrationError.

    Un elenco di errori associati alla creazione dell'integrazione.

  • DataFilter— UTF-8 stringa, lunga non meno di 1 o più di 2048 byte.

    Seleziona le tabelle di origine per l'integrazione con la sintassi del filtro Maxwell.

  • IntegrationConfig: un oggetto IntegrationConfig.

    Le impostazioni di configurazione.

Errori
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • IntegrationConflictOperationFault

  • IntegrationQuotaExceededFault

  • KMSKeyNotAccessibleFault

  • EntityNotFoundException

  • InternalServiceException

  • ConflictException

  • ResourceNumberLimitExceededException

  • InvalidInputException

ModifyIntegration azione (Python: modify_integration)

Modifica un' Zero-ETL integrazione nell'account del chiamante.

Richiesta
  • IntegrationIdentifier UTF-8 Obbligatoria: stringa lunga non meno di 1 o più di 128 byte.

    Il nome della risorsa Amazon (ARN) dell'integrazione.

  • Description— UTF-8 stringa, lunga non più di 1000 byte, corrispondente a. Custom string pattern #17

    Una descrizione dell'integrazione.

  • DataFilter— UTF-8 stringa, lunga non meno di 1 o più di 2048 byte.

    Seleziona le tabelle di origine per l'integrazione con la sintassi del filtro Maxwell.

  • IntegrationConfig: un oggetto IntegrationConfig.

    Le impostazioni di configurazione dell'integrazione. Attualmente, RefreshInterval può essere modificato solo il.

  • IntegrationName— UTF-8 stringa lunga non meno di 1 o più di 128 byte.

    Un nome univoco per un'integrazione in AWS Glue.

Risposta
  • SourceArn UTF-8 Obbligatoria: stringa di lunghezza non inferiore a 1 o superiore a 512 byte.

    L'ARN dell'origine dell'integrazione.

  • TargetArn UTF-8 Obbligatoria: stringa di lunghezza non inferiore a 1 o superiore a 512 byte.

    L'ARN della destinazione dell'integrazione.

  • IntegrationName UTF-8 Obbligatoria: stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Un nome univoco per un'integrazione in AWS Glue.

  • Description— UTF-8 stringa, lunga non più di 1000 byte, corrispondente a. Custom string pattern #17

    Una descrizione dell'integrazione.

  • IntegrationArn UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 128 byte.

    Il nome della risorsa Amazon (ARN) dell'integrazione.

  • KmsKeyId— UTF-8 stringa, lunga non meno di 1 o più di 2048 byte.

    L'ARN di una chiave KMS utilizzata per crittografare il canale.

  • AdditionalEncryptionContext: una matrice della mappa di coppie chiave-valore.

    Ogni chiave è una UTF-8 stringa.

    Ogni valore è una UTF-8 stringa.

    Un set facoltativo di coppie chiave-valore che contengono ulteriori informazioni contestuali per la crittografia.

  • Tags: una matrice di oggetti Tag.

    I metadati assegnati alla risorsa costituita da un elenco di coppie chiave-valore.

  • Status Obbligatorio: UTF-8 stringa (valori validi: CREATING ACTIVE MODIFYING | FAILED | DELETING | | SYNCING |NEEDS_ATTENTION).

    Lo stato dell'integrazione in fase di modifica.

    I possibili stati sono:

    • CREATING: l'integrazione è in fase di creazione.

    • ACTIVE: la creazione dell'integrazione ha esito positivo.

    • MODIFYING: l'integrazione è in fase di modifica.

    • FAILED: la creazione dell'integrazione ha esito negativo.

    • DELETING: l'integrazione viene eliminata.

    • SYNCING: l'integrazione è in fase di sincronizzazione.

    • NEEDS_ATTENTION: l'integrazione richiede attenzione, ad esempio per la sincronizzazione.

  • CreateTime - obbligatorio: timestamp.

    L'ora di creazione dell'integrazione, in fuso orario UTC.

  • Errors: una matrice di oggetti IntegrationError.

    Un elenco di errori associati alla modifica dell'integrazione.

  • DataFilter— UTF-8 stringa, lunga non meno di 1 o più di 2048 byte.

    Seleziona le tabelle di origine per l'integrazione con la sintassi del filtro Maxwell.

  • IntegrationConfig: un oggetto IntegrationConfig.

    Le impostazioni di configurazione dell'integrazione aggiornate.

Errori
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • IntegrationNotFoundFault

  • IntegrationConflictOperationFault

  • InvalidIntegrationStateFault

  • EntityNotFoundException

  • InternalServiceException

  • ConflictException

  • InvalidStateException

  • InvalidInputException

DescribeIntegrations azione (Python: describe_integrations)

L'API viene utilizzata per recuperare un elenco di integrazioni.

Richiesta
  • IntegrationIdentifier— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Il nome della risorsa Amazon (ARN) dell'integrazione.

  • Marker— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Un valore che indica il punto di partenza per il set di record di risposta successivo in una richiesta seguente.

  • MaxRecords: numero (intero).

    Il numero totale di elementi da restituire nell'output.

  • Filters: una matrice di oggetti IntegrationFilter.

    Un elenco di chiavi e valori per filtrare i risultati. Le chiavi supportate sono «Status», "IntegrationName«e"SourceArn». IntegrationName è limitato a un solo valore.

Risposta
  • Integrations: una matrice di oggetti Integrazione.

    Un elenco di integrazioni Zero-ETL.

  • Marker— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Un valore che indica il punto di partenza per il set di record di risposta successivo in una richiesta seguente.

Errori
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • IntegrationNotFoundFault

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

DeleteIntegration azione (Python: delete_integration)

Elimina l'integrazione specificata. Zero-ETL

Richiesta
  • IntegrationIdentifier UTF-8 Obbligatoria: stringa lunga non meno di 1 o più di 128 byte.

    Il nome della risorsa Amazon (ARN) dell'integrazione.

Risposta
  • SourceArn UTF-8 Obbligatoria: stringa di lunghezza non inferiore a 1 o superiore a 512 byte.

    L'ARN dell'origine dell'integrazione.

  • TargetArn UTF-8 Obbligatoria: stringa di lunghezza non inferiore a 1 o superiore a 512 byte.

    L'ARN della destinazione dell'integrazione.

  • IntegrationName UTF-8 Obbligatoria: stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Un nome univoco per un'integrazione in AWS Glue.

  • Description— UTF-8 stringa, lunga non più di 1000 byte, corrispondente a. Custom string pattern #17

    Una descrizione dell'integrazione.

  • IntegrationArn UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 128 byte.

    Il nome della risorsa Amazon (ARN) dell'integrazione.

  • KmsKeyId— UTF-8 stringa, lunga non meno di 1 o più di 2048 byte.

    L'ARN di una chiave KMS utilizzata per crittografare il canale.

  • AdditionalEncryptionContext: una matrice della mappa di coppie chiave-valore.

    Ogni chiave è una UTF-8 stringa.

    Ogni valore è una UTF-8 stringa.

    Un set facoltativo di coppie chiave-valore che contengono ulteriori informazioni contestuali per la crittografia.

  • Tags: una matrice di oggetti Tag.

    I metadati assegnati alla risorsa costituita da un elenco di coppie chiave-valore.

  • Status Obbligatorio: UTF-8 stringa (valori validi: CREATING ACTIVE MODIFYING | FAILED | DELETING | | SYNCING |NEEDS_ATTENTION).

    Lo stato dell'integrazione in fase di eliminazione.

    I possibili stati sono:

    • CREATING: l'integrazione è in fase di creazione.

    • ACTIVE: la creazione dell'integrazione ha esito positivo.

    • MODIFYING: l'integrazione è in fase di modifica.

    • FAILED: la creazione dell'integrazione ha esito negativo.

    • DELETING: l'integrazione viene eliminata.

    • SYNCING: l'integrazione è in fase di sincronizzazione.

    • NEEDS_ATTENTION: l'integrazione richiede attenzione, ad esempio per la sincronizzazione.

  • CreateTime - obbligatorio: timestamp.

    L'ora di creazione dell'integrazione, in fuso orario UTC.

  • Errors: una matrice di oggetti IntegrationError.

    Un elenco di errori associati all'integrazione.

  • DataFilter— UTF-8 stringa, lunga non meno di 1 o più di 2048 byte.

    Seleziona le tabelle di origine per l'integrazione con la sintassi del filtro Maxwell.

Errori
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • IntegrationNotFoundFault

  • IntegrationConflictOperationFault

  • InvalidIntegrationStateFault

  • EntityNotFoundException

  • InternalServiceException

  • ConflictException

  • InvalidStateException

  • InvalidInputException

DescribeInboundIntegrations azione (Python: describe_inbound_integrations)

Restituisce un elenco di integrazioni in entrata per l'integrazione specificata.

Richiesta
  • IntegrationArn— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Il nome della risorsa Amazon (ARN) dell'integrazione.

  • Marker— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Token per specificare dove iniziare l'impaginazione. Si tratta del marcatore di una risposta precedentemente troncata.

  • MaxRecords: numero (intero).

    Il numero totale di elementi da restituire nell'output.

  • TargetArn— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 512 byte.

    Il nome della risorsa Amazon (ARN) della risorsa di destinazione nell'integrazione.

Risposta
  • InboundIntegrations: una matrice di oggetti InboundIntegration.

    Un elenco di integrazioni in entrata.

  • Marker— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Un valore che indica il punto di partenza per il set di record di risposta successivo in una richiesta seguente.

Errori
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • IntegrationNotFoundFault

  • TargetResourceNotFound

  • OperationNotSupportedException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

CreateIntegrationTableProperties azione (Python: create_integration_table_properties)

Questa API viene utilizzata per fornire proprietà di override facoltative per le tabelle da replicare. Queste proprietà possono includere proprietà di filtraggio e partizionamento per le tabelle di origine e di destinazione. Per impostare le proprietà di origine e di destinazione, è necessario richiamare la stessa API rispettivamente con l'ARN di AWS Glue connessione e con l'ARN del database. ResourceArn SourceTableConfig AWS Glue ResourceArn TargetTableConfig

Richiesta
  • ResourceArn Obbligatoria: UTF-8 stringa lunga non meno di 1 o più di 512 byte.

    Il nome della risorsa Amazon (ARN) della tabella di destinazione per cui creare le proprietà della tabella di integrazione. Attualmente, questa API supporta solo la creazione di proprietà della tabella di integrazione per le tabelle di destinazione e l'ARN fornito deve essere l'ARN della tabella di destinazione nel AWS Glue catalogo dati. Il supporto per la creazione di proprietà della tabella di integrazione per le connessioni di origine (utilizzando l'ARN della connessione) non è ancora implementato e verrà aggiunto in una versione futura.

  • TableName UTF-8 Obbligatoria: stringa lunga non meno di 1 o più di 128 byte.

    Il nome della tabella da replicare.

  • SourceTableConfig: un oggetto SourceTableConfig.

    Una struttura di configurazione della tabella di origine. Consultare la struttura SourceTableConfig per un elenco di proprietà di origine supportate.

  • TargetTableConfig: un oggetto TargetTableConfig.

    Una struttura di configurazione della tabella di destinazione.

Risposta
  • Nessun parametro di risposta.

Errori
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

UpdateIntegrationTableProperties azione (Python: update_integration_table_properties)

Questa API viene utilizzata per fornire proprietà di override facoltative per le tabelle da replicare. Queste proprietà possono includere proprietà di filtraggio e partizionamento per le tabelle di origine e di destinazione. Per impostare le proprietà di origine e di destinazione, è necessario richiamare la stessa API rispettivamente con l'ARN di AWS Glue connessione e con l'ARN del database. ResourceArn SourceTableConfig AWS Glue ResourceArn TargetTableConfig

L'override si rifletterà in tutte le integrazioni che utilizzano lo stesso ResourceArn e la stessa tabella di origine.

Richiesta
  • ResourceArn Obbligatoria: UTF-8 stringa lunga non meno di 1 o più di 512 byte.

    L'ARN di connessione dell'origine o l'ARN del database della destinazione.

  • TableName UTF-8 Obbligatoria: stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Il nome della tabella da replicare.

  • SourceTableConfig: un oggetto SourceTableConfig.

    Una struttura di configurazione della tabella di origine.

  • TargetTableConfig: un oggetto TargetTableConfig.

    Una struttura di configurazione della tabella di destinazione.

Risposta
  • Nessun parametro di risposta.

Errori
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

GetIntegrationTableProperties azione (Python: get_integration_table_properties)

Questa API viene utilizzata per recuperare le proprietà di override facoltative per le tabelle da replicare. Queste proprietà possono includere proprietà di filtraggio e partizione per le tabelle di origine e di destinazione.

Richiesta
  • ResourceArn Obbligatoria: UTF-8 stringa lunga non meno di 1 o più di 512 byte.

    Il nome della risorsa Amazon (ARN) della tabella di destinazione per cui recuperare le proprietà della tabella di integrazione. Attualmente, questa API supporta solo il recupero delle proprietà per le tabelle di destinazione e l'ARN fornito deve essere l'ARN della tabella di destinazione nel catalogo dati. AWS Glue Il supporto per il recupero delle proprietà della tabella di integrazione per le connessioni di origine (utilizzando l'ARN della connessione) non è ancora implementato e verrà aggiunto in una versione futura.

  • TableName Obbligatoria: UTF-8 stringa lunga non meno di 1 o più di 128 byte.

    Il nome della tabella da replicare.

Risposta
  • ResourceArn— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 512 byte.

    Il nome della risorsa Amazon (ARN) della tabella di destinazione per cui recuperare le proprietà della tabella di integrazione. Attualmente, questa API supporta solo il recupero delle proprietà per le tabelle di destinazione e l'ARN fornito deve essere l'ARN della tabella di destinazione nel catalogo dati. AWS Glue Il supporto per il recupero delle proprietà della tabella di integrazione per le connessioni di origine (utilizzando l'ARN della connessione) non è ancora implementato e verrà aggiunto in una versione futura.

  • TableName— UTF-8 stringa lunga non meno di 1 o più di 128 byte.

    Il nome della tabella da replicare.

  • SourceTableConfig: un oggetto SourceTableConfig.

    Una struttura di configurazione della tabella di origine.

  • TargetTableConfig: un oggetto TargetTableConfig.

    Una struttura di configurazione della tabella di destinazione.

Errori
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

DeleteIntegrationTableProperties azione (Python: delete_integration_table_properties)

Elimina le proprietà della tabella create per le tabelle da replicare.

Richiesta
  • ResourceArn Obbligatoria: UTF-8 stringa lunga non meno di 1 o più di 512 byte.

    L'ARN di connessione dell'origine o l'ARN del database della destinazione.

  • TableName UTF-8 Obbligatoria: stringa di lunghezza non inferiore a 1 o superiore a 128 byte.

    Il nome della tabella da replicare.

Risposta
  • Nessun parametro di risposta.

Errori
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

CreateIntegrationResourceProperty azione (Python: create_integration_resource_property)

Questa API può essere utilizzata per configurare la AWS Glue connessione (per l'origine) o l'ResourcePropertyARN del database (per la destinazione). AWS Glue Queste proprietà possono includere il ruolo per accedere alla connessione o al database. Per impostare le proprietà di origine e di destinazione, è necessario richiamare la stessa API rispettivamente con l'ARN di AWS Glue connessione SourceProcessingProperties e l'ARN del AWS Glue database ResourceArn con. ResourceArn TargetProcessingProperties

Richiesta
  • ResourceArn Obbligatoria: UTF-8 stringa lunga non meno di 1 o più di 512 byte.

    L'ARN di connessione dell'origine o l'ARN del database della destinazione.

  • SourceProcessingProperties: un oggetto SourceProcessingProperties.

    Le proprietà della risorsa associate all'origine dell'integrazione.

  • TargetProcessingProperties: un oggetto TargetProcessingProperties.

    Le proprietà della risorsa associate alla destinazione dell'integrazione.

  • Tags: una matrice di oggetti Tag.

    I metadati assegnati alla risorsa costituita da un elenco di coppie chiave-valore.

Risposta
  • ResourceArn UTF-8 Obbligatoria: stringa di lunghezza non inferiore a 1 o superiore a 512 byte.

    L'ARN di connessione dell'origine o l'ARN del database della destinazione.

  • ResourcePropertyArn— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 512 byte.

    La risorsa ARN creata tramite questa API di creazione. <region><account_id>Il formato è qualcosa come arn:aws:glue: ::integrationresourceproperty/*

  • SourceProcessingProperties: un oggetto SourceProcessingProperties.

    Le proprietà della risorsa associate all'origine dell'integrazione.

  • TargetProcessingProperties: un oggetto TargetProcessingProperties.

    Le proprietà della risorsa associate alla destinazione dell'integrazione.

Errori
  • ValidationException

  • AccessDeniedException

  • ConflictException

  • InternalServerException

  • ResourceNotFoundException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

UpdateIntegrationResourceProperty azione (Python: update_integration_resource_property)

Questa API può essere utilizzata per aggiornare la AWS Glue connessione (per l'origine) o l'ARN ResourceProperty del database (per la destinazione). AWS Glue Queste proprietà possono includere il ruolo per accedere alla connessione o al database. Dato che la stessa risorsa può essere utilizzata in più integrazioni, l'aggiornamento delle proprietà della risorsa influiranno su tutte le integrazioni che la utilizzano.

Richiesta
  • ResourceArn UTF-8 Obbligatoria: stringa lunga non meno di 1 o più di 512 byte.

    L'ARN di connessione dell'origine o l'ARN del database della destinazione.

  • SourceProcessingProperties: un oggetto SourceProcessingProperties.

    Le proprietà della risorsa associate all'origine dell'integrazione.

  • TargetProcessingProperties: un oggetto TargetProcessingProperties.

    Le proprietà della risorsa associate alla destinazione dell'integrazione.

Risposta
  • ResourceArn— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 512 byte.

    L'ARN di connessione dell'origine o l'ARN del database della destinazione.

  • ResourcePropertyArn— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 512 byte.

    La risorsa ARN creata tramite questa API di creazione. <region><account_id>Il formato è qualcosa come arn:aws:glue: ::integrationresourceproperty/*

  • SourceProcessingProperties: un oggetto SourceProcessingProperties.

    Le proprietà della risorsa associate all'origine dell'integrazione.

  • TargetProcessingProperties: un oggetto TargetProcessingProperties.

    Le proprietà della risorsa associate alla destinazione dell'integrazione.

Errori
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • ResourceNotFoundException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

GetIntegrationResourceProperty azione (Python: get_integration_resource_property)

Questa API viene utilizzata per recuperare l'ARN della AWS Glue connessione (per l'ResourcePropertyorigine) o del database (per la destinazione) AWS Glue

Richiesta
  • ResourceArn UTF-8 Obbligatoria: stringa lunga non meno di 1 o più di 512 byte.

    L'ARN di connessione dell'origine o l'ARN del database della destinazione.

Risposta
  • ResourceArn— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 512 byte.

    L'ARN di connessione dell'origine o l'ARN del database della destinazione.

  • ResourcePropertyArn— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 512 byte.

    La risorsa ARN creata tramite questa API di creazione. <region><account_id>Il formato è qualcosa come arn:aws:glue: ::integrationresourceproperty/*

  • SourceProcessingProperties: un oggetto SourceProcessingProperties.

    Le proprietà della risorsa associate all'origine dell'integrazione.

  • TargetProcessingProperties: un oggetto TargetProcessingProperties.

    Le proprietà della risorsa associate alla destinazione dell'integrazione.

Errori
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • ResourceNotFoundException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

UntagResource azione (Python: untag_resource)

Rimuove i tag specificati da una risorsa di integrazione.

Richiesta
  • ResourceArn Obbligatoria: UTF-8 stringa, lunga non meno di 1 o più di 10240 byte, corrispondente a. Custom string pattern #47

    Il nome della risorsa Amazon (ARN) della risorsa di integrazione.

  • TagsToRemove Obbligatorio: una matrice di UTF-8 stringhe, non più di 50 stringhe.

    Un elenco di tag di metadati da rimuovere dalla risorsa.

Risposta
  • Nessun parametro di risposta.

Errori
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

ListTagsForResource azione (Python: list_tags_for_resource)

Elenca i tag di metadati assegnati alla risorsa specificata.

Richiesta
  • ResourceARN Obbligatoria: UTF-8 stringa, lunga non meno di 1 o più di 10240 byte, corrispondente a. Custom string pattern #47

    L'ARN della risorsa.

Risposta
  • Tags: una serie di oggetti Tag, non superiore a 10 strutture.

    Un elenco di tag.

Errori
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

Eccezioni

ResourceNotFoundException struttura

Impossibile trovare la risorsa.

Campi
  • Message— UTF-8 corda.

    Messaggio che descrive il problema.

InternalServerException struttura

Si è verificato un errore interno del server.

Campi
  • Message— UTF-8 corda.

    Messaggio che descrive il problema.

IntegrationAlreadyExistsFault struttura

L'integrazione specificata esiste già.

Campi
  • Message— UTF-8 corda.

    Messaggio che descrive il problema.

IntegrationConflictOperationFault struttura

L'operazione richiesta è in conflitto con un'altra operazione.

Campi
  • Message— UTF-8 corda.

    Messaggio che descrive il problema.

IntegrationQuotaExceededFault struttura

I dati elaborati tramite l'integrazione hanno superato la quota.

Campi
  • Message— UTF-8 corda.

    Messaggio che descrive il problema.

KMSKeyNotAccessibleFault struttura

La chiave KMS specificata non è accessibile.

Campi
  • Message— UTF-8 corda.

    Messaggio che descrive il problema.

IntegrationNotFoundFault struttura

Impossibile trovare l'integrazione specificata.

Campi
  • Message— UTF-8 corda.

    Messaggio che descrive il problema.

TargetResourceNotFound struttura

Impossibile trovare la risorsa di destinazione.

Campi
  • Message— UTF-8 corda.

    Messaggio che descrive il problema.

InvalidIntegrationStateFault struttura

L'integrazione si trova in uno stato non valido.

Campi
  • Message— UTF-8 corda.

    Messaggio che descrive il problema.