TestversionSynkronisera HubSpot-data till Amazon S3

Använd Amazon S3-integrationen för att synkronisera data från HubSpot CRM till en Amazon S3-bucket som du äger. Du kan välja vilka objekt, kopplingar och händelser som ska synkroniseras, ställa in ett återkommande synkroniseringsschema och övervaka synkroniseringsstatusen direkt i HubSpot.

Vid varje synkronisering exporteras en fullständig ögonblicksbild av de valda uppgifterna i Parquet-format till din Amazon S3-bucket. Du kan sedan använda de synkroniserade uppgifterna med analys- och databehandlingsverktyg, såsom AWS Glue, Amazon Athena, Amazon EMR, Spark, Databricks eller Python-notebooks.

Observera: Amazon S3-integrationen är tillgänglig för nya Amazon S3-användare som inte använder den äldre Amazon S3-integrationen. Om du är superadministratör kan du anmäla ditt konto till betaversionen av den nya Amazon S3-integrationen.

Innan du börjar

Innan du börjar synkronisera data till Amazon S3 bör du läsa igenom följande krav och begränsningar.

Förstå kraven

• Om du är superadministratör kan du anmäla ditt konto till betaversionen av Amazon S3-integrationen.
• Du måste skapa en AWS Identity and Access Management (IAM)-roll som är kopplad till ditt HubSpot-konto.

Förstå begränsningar och överväganden

• Under betafasen synkroniseras data endast i Parquet-format.
• Varje synkronisering skapar en fullständig ögonblicksbild av de valda uppgifterna.
• HubSpot skapar en ny mapp för varje synkronisering och tar inte bort tidigare synkroniseringar från din S3-bucket.
• Synkronisering avkänslig data stöds inte.

Skapa IAM-rollen i AWS

Så här konfigurerar du åtkomstbehörigheter för HubSpot i AWS Management Console:

1. Logga in på AWS Management Console.
2. På startsidan klickar du på Tjänster > Säkerhet, identitet och efterlevnad > IAM.
3. Klicka på Roller i vänster sidomeny.
4. Klicka på Skapa roll.
5. I avsnittet Typ av betrodd enhet väljer du ditt AWS-konto.
6. I avsnittet AWS-konto väljer du Ett annat AWS-konto och anger ditt eget AWS-konto-ID. Du kommer senare att ändra förtroenderelationen för att ge åtkomst till HubSpot.
7. Välj Kräv externt ID och ange ett platshållar-ID, till exempel 0000. Du kommer senare att ändra förtroenderelationen för din IAM-roll och ange det externa ID:t för din lagringsintegration. Ett externt ID används för att bevilja åtkomst till dina AWS-resurser för en tredjepartsapp som HubSpot.

8. Klicka på Nästa.
9. I avsnittet Rollinformation anger du ett Rollnamn och en Beskrivning för att identifiera rollen.
10. Klicka på Skapa roll.
11. Kopiera ARN-värdet på sidan Sammanfattning. Du kommer att använda detta värde i nästa steg.

Anslut HubSpot och AWS S3

1. I ditt HubSpot-konto klickar du på Marketplace-ikonen i det övre navigeringsfältet och väljer sedan HubSpot Marketplace.
2. Sök efter och välj Amazon S3 i sökfältet.
3. Klicka på Installera.
4. Välj din AWS IAM -roll och klicka sedan på Installera.
5. Klicka på Nästa.
6. Ange ARN-värdet från AWS IAM-rollen i fältet Roll-ARN.
7. Klicka på Anslut till Amazon S3.

Konfigurera behörigheter för bucket

HubSpot behöver följande behörigheter för en AWS S3-bucket och mapp för att kunna komma åt filer i mappen och undermapparna:

• s3:GetBucketLocation
• s3:GetObject
• s3:GetObjectVersion
• s3:ListBucket
• s3:Lägg till objekt
• s3:DeleteObject

När du har anslutit appen ska du ge HubSpot behörighet att synkronisera data till din S3-bucket.

1. I ditt HubSpot-konto klickar du på inställningsikonen i det övre navigeringsfältet. I den vänstra sidomenyn går du till Integreringar > Anslutna appar.
2. Klicka på Amazon S3.
3. I den högra panelen klickar du på Välj för det Amazon S3-konto som du vill synkronisera data till.
4. På sidan ”Behörigheter” klickar du på ”Kopiera” för att kopiera exempelpolicyn för behörigheter och koppla den till den AWS IAM-roll som du skapade tidigare. Tänk på att uppdatera behörighetspolicyn med namnen på dina buckets.

5. Logga in på AWS Management Console.
6. På startsidan klickar du på Tjänster > Säkerhet, identitet och efterlevnad > IAM.
7. Klicka på Kontoinställningar i vänster sidomeny.
8. I avsnittet Security Token Service (STS) letar du efter den AWS-region som motsvarar den region där ditt AWS-konto finns. Klicka för att slå på strömbrytaren och aktivera regionen.
9. Klicka på Policies i vänsterpanelen.
10. Klicka på Skapa policy.
11. Klicka på Lägg till nytt uttalande på fliken JSON.
12. Lägg till den policy som du kopierade i steg 4, som ger HubSpot de behörigheter som krävs för att ladda upp eller ladda ner data med hjälp av en enda bucket och mappväg.

13. Klicka på Nästa.
14. I avsnittet Granska och skapa anger du policyns namn och en valfri beskrivning.
15. Klicka på Skapa policy.

Konfigurera målbucket

1. Tillbaka på sidan Behörigheter i HubSpot anger du namnet på bucketen i fältet Bucket.
2. Klicka på Testa anslutning.

3. Om anslutningstestet lyckas klickar du på Nästa.

Konfigurera synkroniseringen

1. På sidan Datakälla väljer du de data som du vill synkronisera.
2. Markera kryssrutorna för de objekt, kopplingar och händelser som du vill synkronisera från HubSpot till Amazon S3.

3. Klicka på Nästa.
4. På sidan Detaljer klickar du på rullgardinsmenyn Synkroniseringsfrekvens och väljer den frekvens med vilken du vill att data ska synkroniseras från HubSpot till Amazon S3.

5. Klicka på Starta synkronisering.

Hantera synkroniseringen

När du har konfigurerat en synkronisering och data börjar synkroniseras från HubSpot till Amazon S3 kan du granska dess status, identifiera fel, uppdatera inställningar eller arkivera synkroniseringen.

Så här granskar och hanterar du synkroniseringen:

1. I ditt HubSpot-konto klickar du på Mer och navigerar sedan till Datahantering > Dataintegration. Om Mer inte visas i ditt konto navigerar du direkt till Datahantering > Data Integration.
2. Gå till fliken Appsynkroniseringar och leta reda på din Amazon S3-synkronisering i tabellen.
3. Granska synkroniseringsstatusen:

• • Synkronisering: en synkronisering pågår.
  • Synkroniserad: den senaste synkroniseringen slutfördes utan problem.
  • Misslyckades: ett fel uppstod vid den senaste synkroniseringen.
  • Arkiverad: synkroniseringskonfigurationen har tagits bort.

4. Klicka på synkroniseringsnamnet för att visa mer information, inklusive poster som har synkroniserats och poster där synkroniseringen misslyckades.

Så här redigerar eller tar du bort en synkronisering:

1. Klicka på Amazon S3 -synkroniseringen i tabellen.
2. Klicka på rullgardinsmenyn Åtgärder längst upp till höger och välj sedan ett av följande alternativ:

• • Redigera synkronisering: uppdatera synkroniseringsinställningarna.
  • Arkivera synkronisering: ta bort synkroniseringskonfigurationen.

Dataformat för synkronisering mellan HubSpot och Amazon S3

Tillgängliga data för synkronisering

Du kan synkronisera följande data från HubSpot till AWS S3:

• Objekt: standardobjekt och anpassade objekt, till exempel kontakter, företag, ärenden eller produkter.
• Poster: enskilda objektposter.
• Egenskaper: egenskaper och deras värden i objektregistren, inklusive egenskapshistoriken.
• Kopplingar: alla kopplingstyper och kopplade poster.
• Händelser: utvalda standardhändelser i HubSpot och anpassade beteendehändelser, inklusive utvalda händelseegenskaper.

Objektdata av olika typer organiseras och är tillgängliga på två sätt:

• Individuellt: varje objekttyp lagras i sin egen tabell och innehåller endast poster av samma objekttyp. Till exempel innehåller objects_contacts endast kontaktposter.
• Kombinerat: alla poster för alla objekttyper slås samman till ett enda databasobjekt. Vid sökningar måste du därför ange ett filter som ”WHERE objectTypeId=’0-1’

Anpassade objekt tilldelas ett ID vid skapandet och identifieras som 2-unikt_ID. Till exempel 2-12345.

S3-mappstruktur

HubSpot skriver varje lyckad synkronisering till ett HubSpot-hanterat prefix i din Amazon S3-bucket enligt följande struktur:

s3://<bucket-name>/hubspot-dataout/<account-id>/<run-id>/<table-name>/<file-name>

Till exempel:

s3://my-company-hubspot-data/hubspot-dataout/12345678/98765/OBJECT_WITH_OBJECT_PROPERTIES/part-000.parquet

s3://my-company-hubspot-data/hubspot-dataout/12345678/98765/EVENTS_VISITED_PAGE/part-000.parquet

s3://my-company-hubspot-data/hubspot-dataout/12345678/98765/ASSOCIATIONS_CONTACTS_TO_COMPANIES/part-000.parquet

Varje synkronisering skapar en ny mapp run-id. HubSpot raderar inte data från tidigare synkroniseringar.

Om du vill ta bort äldre synkroniseringar automatiskt ska du konfigurera en Amazon S3-livscykelpolicy för bucketen eller prefixet.

HubSpot genererar filnamn för varje synkroniseringskörning, och filnamnen kan variera mellan olika körningar. Konfigurera inte efterföljande processer så att de är beroende av specifika filnamn. Läs istället in alla filer i den mapp med lämpligt tabellnamn som motsvarar den exportkörning du vill bearbeta.

Objektfiler

Om du väljer objektdata exporterar HubSpot följande mappar.

OBJECTS_PROPERTIES

En rad per objektets egenskapsvärde.

OBJECT_WITH_OBJECT_PROPERTIES

En rad per objektrekord, där valda egenskapsvärden grupperas i en enda kolumn med namnet PROPERTIES.

För att läsa en specifik objekttyp från den här mappen, filtrera efter OBJECTTYPEID.

Associeringsfiler

Om du väljer associeringsdata synkroniserar HubSpot associeringsposter och associeringsdefinitioner.

ASSOCIATIONS

En rad per vald koppling mellan två objektregister.

ASSOCIATION_DEFINITIONS

En rad per vald kopplingsdefinition.

ASSOCIATIONS_<FRÅN_OBJEKTTYP>_TILL_<TILL_OBJEKTTYP>

För valda kopplingspar synkroniserar HubSpot även mappar för specifika kopplingspar, till exempel ASSOCIATIONS_CONTACTS_TO_COMPANIES. Dessa mappar innehåller kopplingsposter och tillhörande definitionsmetadata.

Händelsefiler

Om du väljer händelsedata exporterar HubSpot en mapp för varje händelsetyp. Mappnamnen har formatet EVENTS_<EVENT_NAME>, till exempel EVENTS_VISITED_PAGE.

Varje händelsemapp innehåller standardkolumner för händelser samt en kolumn för varje händelseegenskap som valts under konfigurationen.