Integrazione APIs in AWS Glue - AWS Glue
 - tipi di dati -IntegrazioneIntegrationConfigIntegrationPartitionIntegrationErrorIntegrationFilterInboundIntegrationSourceProcessingPropertiesTargetProcessingPropertiesSourceTableConfigTargetTableConfig - operazioni -CreateIntegration (create_integration)ModifyIntegration (modify_integration)DescribeIntegrations (describe_integrazioni)DeleteIntegration (delete_integration)DescribeInboundIntegrations (describe_inbound_integrazioni)CreateIntegrationTableProperties (create_integration_table_properties)UpdateIntegrationTableProperties (update_integration_table_properties)GetIntegrationTableProperties (get_integration_table_properties)DeleteIntegrationTableProperties (delete_integration_table_properties)CreateIntegrationResourceProperty (create_integration_resource_property)UpdateIntegrationResourceProperty (update_integration_resource_property)GetIntegrationResourceProperty (get_integration_resource_property)UntagResource (untag_resource)ListTagsForResource (list_tags_per_resource) - eccezioni -ResourceNotFoundExceptionInternalServerExceptionIntegrationAlreadyExistsFaultIntegrationConflictOperationFaultIntegrationQuotaExceededFaultKMSKeyNotAccessibleFaultIntegrationNotFoundFaultTargetResourceNotFoundInvalidIntegrationStateFault

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à.

Integrazione APIs in AWS Glue

Tipi di dati

Struttura di integrazione

Descrive un'integrazione Zero-ETL.

Campi

  • SourceArn - obbligatorio:, stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 byte.

    L'ARN dell'origine dell'integrazione.

  • TargetArn - obbligatorio:, stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 byte.

    L'ARN della destinazione dell'integrazione.

  • Description: stringa UTF-8, non superiore a 1000 byte di lunghezza, corrispondente a Custom string pattern #12.

    Una descrizione dell'integrazione.

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

    Un nome univoco dell'integrazione.

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

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

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

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

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

    Ogni chiave è una stringa UTF-8.

    Ogni valore è una stringa UTF-8.

    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: stringa UTF-8 (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: stringa UTF-8, non inferiore a 1 o superiore a 2048 byte di lunghezza.

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

IntegrationConfig struttura

Proprietà associate all'integrazione.

Campi

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

    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 stringa UTF-8.

    Ogni valore è una stringa UTF-8.

    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.

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

IntegrationPartition struttura

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

Campi

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

    Il nome del campo utilizzato per partizionare i dati nella destinazione. Evita 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: stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    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: stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    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

    Specificare solo ConversionSpec quando si utilizzano funzioni di partizione basate su timestamp (anno, mese, giorno o ora). AWS Glue Zero-ETL utilizza 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. Tra le colonne ad alta cardinalità vi sono:

    • Chiavi primarie

    • Campi timestamp (come LastModifiedTimestamp, CreatedDate)

    • Timestamp generati dal sistema

    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: stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    Il codice associato a questo errore.

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

    Messaggio che descrive l'errore.

IntegrationFilter struttura

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

Campi

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

    Il nome del filtro.

  • Values: una matrice di stringhe UTF-8.

    Un elenco di valori di filtro.

InboundIntegration struttura

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

Campi

  • SourceArn - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 byte.

    L'ARN della risorsa di origine dell'integrazione.

  • TargetArn - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 byte.

    L'ARN della risorsa di destinazione dell'integrazione.

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

    L'ARN dell'integrazione Zero-ETL.

  • Status - obbligatorio: stringa UTF-8 (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: stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    Il ruolo IAM per accedere alla AWS Glue connessione.

TargetProcessingProperties struttura

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

Campi

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

    Il ruolo IAM per accedere al AWS Glue database.

  • KmsArn: stringa UTF-8, non inferiore a 1 o superiore a 2048 byte di lunghezza.

    L'ARN della chiave KMS utilizzata per la crittografia.

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

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

  • EventBusArn: stringa UTF-8, non inferiore a 1 o superiore a 2048 byte di lunghezza.

    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 matrice di stringhe UTF-8.

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

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

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

  • PrimaryKey: una matrice di stringhe UTF-8.

    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: stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    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: stringa UTF-8 (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: stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    Il nome facoltativo di una tabella di destinazione.

Operazioni

CreateIntegration azione (Python: create_integration)

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

Richiesta

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

    Un nome univoco per un'integrazione in AWS Glue.

  • SourceArn - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 byte.

    L'ARN della risorsa di origine dell'integrazione.

  • TargetArn - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 byte.

    L'ARN della risorsa di destinazione dell'integrazione.

  • Description: stringa UTF-8, non superiore a 1000 byte di lunghezza, corrispondente a Custom string pattern #12.

    Una descrizione dell'integrazione.

  • DataFilter: stringa UTF-8, non inferiore a 1 o superiore a 2048 byte di lunghezza.

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

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

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

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

    Ogni chiave è una stringa UTF-8.

    Ogni valore è una stringa UTF-8.

    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 - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 byte.

    L'ARN della risorsa di origine dell'integrazione.

  • TargetArn - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 byte.

    L'ARN della risorsa di destinazione dell'integrazione.

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

    Un nome univoco per un'integrazione in AWS Glue.

  • Description: stringa UTF-8, non superiore a 1000 byte di lunghezza, corrispondente a Custom string pattern #12.

    Una descrizione dell'integrazione.

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

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

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

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

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

    Ogni chiave è una stringa UTF-8.

    Ogni valore è una stringa UTF-8.

    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: stringa UTF-8 (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: stringa UTF-8, non inferiore a 1 o superiore a 2048 byte di lunghezza.

    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'integrazione zero-ETL nell'account del chiamante.

Richiesta

  • IntegrationIdentifier - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 byte.

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

  • Description: stringa UTF-8, non superiore a 1000 byte di lunghezza, corrispondente a Custom string pattern #12.

    Una descrizione dell'integrazione.

  • DataFilter: stringa UTF-8, non inferiore a 1 o superiore a 2048 byte di lunghezza.

    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, solo il RefreshInterval può essere modificato.

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

    Un nome univoco per un'integrazione in AWS Glue.

Risposta

  • SourceArn - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 byte.

    L'ARN dell'origine dell'integrazione.

  • TargetArn - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 byte.

    L'ARN della destinazione dell'integrazione.

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

    Un nome univoco per un'integrazione in AWS Glue.

  • Description: stringa UTF-8, non superiore a 1000 byte di lunghezza, corrispondente a Custom string pattern #12.

    Una descrizione dell'integrazione.

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

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

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

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

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

    Ogni chiave è una stringa UTF-8.

    Ogni valore è una stringa UTF-8.

    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: stringa UTF-8 (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: stringa UTF-8, non inferiore a 1 o superiore a 2048 byte di lunghezza.

    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: stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

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

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

    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: stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    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 Zero-ETL specificata.

Richiesta

  • IntegrationIdentifier - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 byte.

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

Risposta

  • SourceArn - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 byte.

    L'ARN dell'origine dell'integrazione.

  • TargetArn - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 byte.

    L'ARN della destinazione dell'integrazione.

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

    Un nome univoco per un'integrazione in AWS Glue.

  • Description: stringa UTF-8, non superiore a 1000 byte di lunghezza, corrispondente a Custom string pattern #12.

    Una descrizione dell'integrazione.

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

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

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

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

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

    Ogni chiave è una stringa UTF-8.

    Ogni valore è una stringa UTF-8.

    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: stringa UTF-8 (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: stringa UTF-8, non inferiore a 1 o superiore a 2048 byte di lunghezza.

    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_integrazioni)

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

Richiesta

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

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

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

    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: stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    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: stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    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 sia le proprietà di origine che quelle di destinazione, è necessario richiamare la stessa API con l'ARN ResourceArn di AWS Glue connessione e l'ResourceArnARN del AWS Glue database rispettivamente SourceTableConfig con. TargetTableConfig

Richiesta

  • ResourceArn - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 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 dovrebbe essere l'ARN della tabella di destinazione nel Data Catalog. AWS Glue 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 - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 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 sia le proprietà di origine che quelle di destinazione, è necessario richiamare la stessa API con l'ARN ResourceArn di AWS Glue connessione e l'ResourceArnARN del AWS Glue database rispettivamente SourceTableConfig con. TargetTableConfig

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

Richiesta

  • ResourceArn - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 byte.

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

  • TableName - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non 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 - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 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 dovrebbe essere l'ARN della tabella di destinazione nel Data Catalog. 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 - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 byte.

    Il nome della tabella da replicare.

Risposta

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

    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 dovrebbe essere l'ARN della tabella di destinazione nel Data Catalog. 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: stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    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 - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 byte.

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

  • TableName - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non 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 ResourceProperty AWS Glue connessione (per l'origine) o l'ARN del AWS Glue database (per la destinazione). Queste proprietà possono includere il ruolo per accedere alla connessione o al database. Per impostare sia le proprietà di origine che quelle di destinazione, è necessario richiamare la stessa API rispettivamente con la AWS Glue connessione ARN ResourceArn as SourceProcessingProperties with e il AWS Glue database ResourceArn ARN come with. TargetProcessingProperties

Richiesta

  • ResourceArn - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 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 - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 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.

Errori

  • ValidationException

  • AccessDeniedException

  • ConflictException

  • InternalServerException

  • ResourceNotFoundException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

UpdateIntegrationResourceProperty azione (Python: update_integration_resource_property)

Questa API può essere utilizzata per aggiornare la ResourceProperty AWS Glue connessione (per l'origine) o l'ARN del AWS Glue database (per la destinazione). 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 - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 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: stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    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.

Errori

  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • ResourceNotFoundException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

GetIntegrationResourceProperty azione (Python: get_integration_resource_property)

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

Richiesta

  • ResourceArn - obbligatorio: stringa UTF-8, lunghezza non inferiore a 1 o non superiore a 128 byte.

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

Risposta

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

    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.

Errori

  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • ResourceNotFoundException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

UntagResource azione (Python: untag_resource)

Rimuove i tag specificati da una risorsa di integrazione.

Richiesta

  • ResourceArn - obbligatorio: stringa UTF-8, non inferiore a 1 o superiore a 10240 byte di lunghezza, corrispondente a Custom string pattern #50.

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

  • TagsToRemove - obbligatorio: una matrice di stringhe UTF-8, non superiore a 50 stringhe.

    Un elenco di tag di metadati da rimuovere dalla risorsa.

Risposta

  • Nessun parametro di risposta.

Errori

  • ResourceNotFoundException

ListTagsForResource azione (Python: list_tags_for_resource)

Elenca i tag di metadati assegnati alla risorsa specificata.

Richiesta

  • ResourceARN - obbligatorio: stringa UTF-8, non inferiore a 1 o superiore a 10240 byte di lunghezza, corrispondente a Custom string pattern #50.

    L'ARN della risorsa.

Risposta

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

    Un elenco di tag.

Errori

  • ResourceNotFoundException

Eccezioni

ResourceNotFoundException struttura

Impossibile trovare la risorsa.

Campi

  • Message: stringa UTF-8.

    Messaggio che descrive il problema.

InternalServerException struttura

Si è verificato un errore interno del server.

Campi

  • Message: stringa UTF-8.

    Messaggio che descrive il problema.

IntegrationAlreadyExistsFault struttura

L'integrazione specificata esiste già.

Campi

  • Message: stringa UTF-8.

    Messaggio che descrive il problema.

IntegrationConflictOperationFault struttura

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

Campi

  • Message: stringa UTF-8.

    Messaggio che descrive il problema.

IntegrationQuotaExceededFault struttura

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

Campi

  • Message: stringa UTF-8.

    Messaggio che descrive il problema.

KMSKeyNotAccessibleFault struttura

La chiave KMS specificata non è accessibile.

Campi

  • Message: stringa UTF-8.

    Messaggio che descrive il problema.

IntegrationNotFoundFault struttura

Impossibile trovare l'integrazione specificata.

Campi

  • Message: stringa UTF-8.

    Messaggio che descrive il problema.

TargetResourceNotFound struttura

Impossibile trovare la risorsa di destinazione.

Campi

  • Message: stringa UTF-8.

    Messaggio che descrive il problema.

InvalidIntegrationStateFault struttura

L'integrazione si trova in uno stato non valido.

Campi

  • Message: stringa UTF-8.

    Messaggio che descrive il problema.