Origine Amazon Kinesis

Last update: Tue Jun 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

Creato per:

Sviluppatore

IMPORTANT

L'origine Amazon Kinesis è disponibile nel catalogo delle origini per gli utenti che hanno acquistato Real-Time CDP Ultimate.
È ora possibile utilizzare l'origine Amazon Kinesis quando si esegue Adobe Experience Platform su Amazon Web Services (AWS). Experience Platform in esecuzione su AWS è attualmente disponibile per un numero limitato di clienti. Per ulteriori informazioni sull'infrastruttura Experience Platform supportata, consulta la Panoramica multi-cloud di Experience Platform.

Adobe Experience Platform fornisce connettività nativa per i provider di cloud come AWS, Google Cloud Platform e Azure. È possibile inserire i dati da questi sistemi in Experience Platform.

Le origini di archiviazione cloud possono inserire i tuoi dati in Experience Platform senza dover scaricare, formattare o caricare. I dati acquisiti possono essere formattati come XDM JSON, XDM Parquet o delimitati. Ogni passaggio del processo viene integrato nel flusso di lavoro Origini. Experience Platform consente di inserire dati da Amazon Kinesis in tempo reale.

NOTE

Il fattore di scala per Kinesis deve essere aumentato se è necessario acquisire dati di volume elevato. Attualmente, il volume massimo di dati che puoi portare dal tuo account Kinesis ad Experience Platform è di 4000 record al secondo. Per aumentare e acquisire dati con volumi più elevati, contatta il tuo rappresentante Adobe.

Prerequisiti

Nella sezione seguente vengono fornite ulteriori informazioni sui prerequisiti necessari per creare una connessione di origine Kinesis.

Configurare i criteri di accesso

Un flusso Kinesis richiede le seguenti autorizzazioni per creare una connessione di origine:

GetShardIterator
GetRecords
DescribeStream
ListStreams

Queste autorizzazioni sono organizzate tramite la console Kinesis e vengono verificate da Experience Platform dopo aver immesso le credenziali e selezionato il flusso di dati.

Nell'esempio seguente vengono visualizzati i diritti di accesso minimi necessari per creare una connessione di origine Kinesis.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "kinesis:GetShardIterator",
                "kinesis:GetRecords",
                "kinesis:DescribeStream",
                "kinesis:ListStreams"
            ],
            "Resource": [
                "arn:aws:kinesis:us-east-2:901341027596:stream/*"
            ]
        }
    ]
}

Proprietà

Descrizione

kinesis:GetShardIterator

Azione necessaria per scorrere i record.

kinesis:GetRecords

Azione necessaria per ottenere record da un ID di offset o di partizione specifico.

kinesis:DescribeStream

Azione che restituisce informazioni relative al flusso, inclusa la mappa di partizioni, necessaria per generare un ID di partizione.

kinesis:ListStreams

Azione necessaria per elencare i flussi disponibili che è possibile selezionare dall’interfaccia utente.

Per ulteriori informazioni sul controllo dell'accesso per Kinesis flussi di dati, vedere il seguente Kinesis documento.

Configura tipo di iteratore

Kinesis supporta i seguenti tipi di iteratore per consentire di specificare l'ordine di lettura dei dati:

Tipo di iteratore

Descrizione

AT_SEQUENCE_NUMBER

I dati vengono letti a partire da una posizione identificata da un numero di sequenza specifico.

AFTER_SEQUENCE_NUMBER

I dati vengono letti a partire dalla posizione identificata da un numero di sequenza specifico.

AT_TIMESTAMP

I dati vengono letti a partire da una posizione identificata da una marca temporale specifica.

TRIM_HORIZON

I dati vengono letti a partire dal record di dati meno recente.

LATEST

I dati vengono letti a partire dal record di dati più recente.

Un'origine dell'interfaccia utente Kinesis attualmente supporta solo TRIM_HORIZON, mentre l'API supporta sia TRIM_HORIZON che LATEST come modalità per ottenere i dati. Il valore predefinito dell'iteratore utilizzato da Experience Platform per l'origine Kinesis è TRIM_HORIZON.

Per ulteriori informazioni sui tipi di iteratore, vedere il Kinesis documento seguente.

Connetti Amazon Kinesis a Experience Platform

NOTE

Dopo aver creato o aggiornato un flusso di dati in streaming, è necessaria una breve pausa di 5 minuti nell’acquisizione dei dati per evitare potenziali istanze di perdita o perdita di dati.

La documentazione seguente fornisce informazioni su come connettere Amazon Kinesis a Experience Platform tramite API o l'interfaccia utente:

Utilizzo delle API

Utilizzo dell’interfaccia utente

recommendation-more-help

337b99bb-92fb-42ae-b6b7-c7042161d089