Privéverbinding met Snowflake

Overwegingen

Gebruik OAuth 2.0 of een privésleutel voor het verifiëren van uw privéverbinding met Snowflake.

Randvoorwaarden

• Vereist Salesforce Private Connect. Voor virtuele privéverbindingen is een extra licentie voor privé verbinden vereist.
• U moet uw Snowflake configureren voor Privékoppeling. Zie de Snowflake-handleiding AWS PrivateLink en Snowflake voor meer informatie.

Voor hulp bij het configureren van deze verbinding zodat deze consistent is met de beveiligingsvereisten van uw organisatie, neemt u contact op met uw netwerkbeveiligings- of IT-afdeling.

De Salesforce AWS-account op de goedgekeurde lijst zetten voor Snowflake Private Connect

Zie Salesforce AWS-account verifiëren voor Privé verbinden om te controleren of uw AWS-account op de goedgekeurde lijst voor Privé verbinden van Salesforce staat.

Verbinden met Snowflake met OAuth

Zie OAuth en aanbieder instellen voor privéverbindingen van Snowflake als u OAuth 2.0 wilt gebruiken voor uw Snowflake-privéverbindingen.

Een uitgaande netwerkverbinding maken

Zie De uitgaande netwerkverbinding maken om een uitgaande netwerkverbinding te maken.

Maak een andere verbinding voor de geïntegreerde Snowflake S3-opslag. Deze verbinding wordt gebruikt wanneer de query grote hoeveelheden gegevens retourneert, omdat Snowflake een afzonderlijk S3-faseringsgebied gebruikt voor grote gegevensoverdrachten, waarvoor een speciale privéverbinding met die S3-bucket is vereist. Snowflake splitst de gegevens op in meerdere bestanden en faseert ze in de geïntegreerde S3-opslag om te downloaden. Voor uitgaande S3-verbindingen is een extra privéverbindingslicentie vereist.

1. Zoek de naam van de VPC S3-eindpuntservice in de AWS Console.
2. Klik op Uitgaande verbinding maken.
3. Selecteer AWS PrivateLink en klik op Volgende.
4. Geef de uitgaande S3-verbinding dezelfde naam als de primaire verbinding, aangevuld met "_S3". Als de primaire verbinding bijvoorbeeld SnowflakeVPCOutbound heet, geeft u de S3-verbinding de naam SnowflakeVPCOutbound_S3.
5. Geef bij Naam van VPC-eindpuntservice de naam van de eindpuntservice op die u in de AWS-console hebt gevonden.
6. Selecteer bij Regio de AWS-regio waarin u Snowflake Private Connect uitvoert.
7. Selecteer Ja, ik wil mijn verbinding nu leveren.
8. Sla de verbinding op.

Zorg ervoor dat de status Verbindingen Gereed is voor beide verbindingen. Als dit niet het geval is, probeert u de verbindingen te synchroniseren.

Een extern inloggegeven maken

1. Geef vanuit Set-up Benoemd op in het vak Snel zoeken en selecteer vervolgens Benoemde inloggegevens.
2. Klik op het tabblad Externe inloggegevens op Nieuw.
3. Geef een label en naam op.
4. Selecteer bij Authenticatieprotocol Geen authenticatie als u OAuth niet gebruikt.
   
5. Als u OAuth gebruikt, selecteert u OAuth 2.0. Selecteer vervolgens Browserstroom als stroomtype en uw externe authenticatie-identiteitsleverancier als identiteitsleverancier.
   
6. Sla uw externe inloggegeven op.
7. Het nieuwe externe inloggegeven openen
8. Klik in de sectie Principals op Nieuw.
9. Geef SnowflakeVPCOAuthPrincipalAccess op als parameternaam, 1 als volgorde en Named Principal als identiteitstype.
10. Als u OAuth 2.0 gebruikt, stelt u het bereik in. Geef voor het bereik twee waarden op, gescheiden door een spatie. De eerste bereikwaarde is session:role:target role, overeenkomend met het bereik dat is ingesteld in de set-upstap Okta. Dit biedt de juiste toegang tot de gegevens op basis van de rol. De tweede bereikwaarde is offline_access, waardoor het vernieuwingstoken wordt geretourneerd vanuit Okta.
    
11. Sla de principal op. Het actiemenu zoeken voor de principal en de
    
    Authenticeren

    Dit opent een browservenster om in te loggen voor Okta. Wanneer authenticatie is geslaagd, wordt de browser omgeleid naar Salesforce en wordt de authenticatiestatus bijgewerkt naar Geconfigureerd. Als de status niet wordt bijgewerkt, controleert u de hoofdinstellingen voor bereik en de set-up van Okta.

Werk uw gebruikersprofiel nu bij met toegang tot principal voor extern inloggegeven.

1. Geef vanuit Set-up Profielen op in het vak Snel zoeken en selecteer vervolgens Profielen.
2. Selecteer het profiel voor de Analytics Cloud Integration User.
3. Klik op Ingeschakelde externe toegang tot hoofdinloggegevens boven aan de profielpagina.
4. Klik op Bewerken en voeg SnowflakeVPCOAuthExtCred - SnowflakeVPCOAuthPrincipalAccess toe.
5. Klik op Opslaan.

Een benoemd gegeven maken

1. Bepaal vanuit Snowflake uw Snowflake-accountnaam in het veld Account-URL van SYSTEM$GET_PRIVATELINK_CONFIG.
2. Geef vanuit Set-up Benoemd op in het vak Snel zoeken en selecteer vervolgens Benoemd gegeven.
3. Klik op het tabblad Benoemde gegevens op Nieuw.
4. Geef een label en naam op.
5. Geef bij URL https://<uw Snowflake-accountnaam>.<uw AWS-regio>.privatelink.snowflakecomputing.com op.
6. Selecteer het externe inloggegeven en de uitgaande netwerkverbinding die u hebt gemaakt.
   
7. Sla uw benoemde gegeven op.

Een Snowflake VPC-verbinding maken

1. Klik op het tabblad Verbindingen van Gegevensbeheer op Nieuwe verbinding.
2. Selecteer Privé, vervolgens de Snowflake Private-connector en klik op Volgende.
   
3. Geef de connectorinstellingen op.
   
4. Klik voor het valideren van uw instellingen en testen van de verbinding op Opslaan en testen. Als de verbinding mislukt, toont CRM Analytics mogelijke redenen.

Alle instellingen vereisen een waarde, tenzij anders is aangegeven.

Instelling	Beschrijving
Verbindingsnaam	Gebruik een naam waarmee u gemakkelijk de verschillende verbindingen van elkaar kunt onderscheiden.
Naam ontwikkelaar	De API-naam wordt in uw gegevensstromen gebruikt om te verwijzen naar gegevens die via deze verbinding worden geëxtraheerd. Deze naam mag geen spaties bevatten. U kunt de API-naam niet wijzigen nadat u de verbinding hebt gemaakt.
Beschrijving	Beschrijving van de verbinding voor intern gebruik.
Authenticatietype	Het type authenticatie dat voor deze verbinding wordt gebruikt. Geaccepteerde waarden zijn OAuth, Password of PrivateKey. PrivateKey wordt aanbevolen als de veiligste optie. Als u OAuth gebruikt, geeft u een waarde op in het veld Benoemd gegeven. Als u Password gebruikt, geeft u een waarde op in de velden Gebruikersnaam en Wachtwoord. Als u PrivateKey gebruikt, geeft u een waarde op in de velden Gebruikersnaam, Persoonlijke sleutel en Toegangsfrase voor persoonlijke sleutel
Benoemd gegeven	Het veld Naam uit het benoemde gegeven dat is opgeslagen in uw Salesforce-organisatie.
Gebruikersnaam	Optioneel. Gebruik voor niet-OAuth-verbindingen. De gebruikersnaam voor de Snowflake-account.
Wachtwoord	Optioneel. Gebruik voor niet-OAuth-verbindingen. Het wachtwoord voor uw Snowflake-account.
Persoonlijke sleutel	Optioneel. De persoonlijke sleutel voor uw Snowflake-account. Opmerking U moet een versleutelde privésleutel en wachtwoord gebruiken die zijn gegenereerd met de Advanced Encryption Standard (AES). Raadpleeg voor de gedetailleerde stappen Sleutelpaarauthenticatie en sleutelpaarrotatie in de Snowflake Help. Wanneer u de opdracht openssl gebruikt om de versleutelde sleutel te genereren, moet u des3 vervangen door aes256 om ervoor te zorgen dat geavanceerde encryptie wordt gebruikt.
Persoonlijke sleuteltoegangsfrase	Optioneel. De toegangsfrase voor de persoonlijke sleutel voor uw Snowflake-account.
Magazijn	De naam van het Snowflake-warehouse is hoofdlettergevoelig, dus geef de waarde exact op zoals deze wordt weergegeven in Snowflake.
Rol	Verplicht voor OAuth-connectoren, optioneel voor geen authenticatie. De Snowflake-rol die is toegewezen aan de gebruikersnaam, moet overeenkomen met de rol die wordt gebruikt voor het Okta-bereik, zoals SYSADMIN.
Database	De naam van de Snowflake-database is hoofdlettergevoelig, dus geef de waarde exact op zoals deze wordt weergegeven in Snowflake.
Schema	De naam van het Snowflake-schema is hoofdlettergevoelig, dus geef de waarde exact op zoals deze wordt weergegeven in Snowflake.

Naar CRM Analytics gesynchroniseerde gegevens filteren

Sluit onnodige of gevoelige gegevens uit van synchroniseren naar CRM Analytics met filters voor gegevenssynchronisatie. Het filter wordt uitgevoerd op het bronobject en versnelt gegevenssynchronisatie door alleen de gegevens op te halen die u nodig hebt in CRM Analytics. Als u verwacht in de toekomst uitgesloten gegevens te gaan gebruiken, gebruikt u een receptfilter in plaats van een gegevenssynchronisatiefilter om te beperken wat er naar een gegevensset wordt geschreven.

1. Ga in Gegevensbeheer naar het tabblad Verbindingen.
2. Selecteer de verbinding die is gekoppeld aan het te filteren object.
3. Klik op het te filteren object.
4. Klik op Filter voor gegevenssynchronisatie en geef het filter op.
5. Klik op Opslaan.

Geef voor de Snowflake-connector een SQL-filter op zoals beschreven in de Snowflake WHERE-documentatie.

Houd het volgende in gedachten als u met de Snowflake-connector werkt.

• U kunt alleen gegevens verplaatsen van Snowflake naar CRM Analytics met deze connector. Er worden geen gegevens geüpload vanuit CRM Analytics naar Snowflake.
• Namen van verbonden objecten moeten beginnen met een letter en mogen slechts letters, cijfers of onderstrepingstekens bevatten. Een objectnaam mag niet eindigen op een onderstrepingsteken.
• Alleen veldnamen met combinaties van alfanumerieke, punt-, onderstrepingstekens of streepjes worden ondersteund. Als een connector veldnamen bevat die andere lettertekens bevatten, zoals spaties of haakjes, mislukt de synchronisatie.
• Er kunnen afrondingsfouten optreden in getallen met zwevende komma's wanneer Snowflake de query uitvoert die gegevens naar de connector verzendt. Zie de Snowflake Help Gegevenstypen voor zwevendekommagetallen voor meer informatie. Als een ID wordt opgegeven als een drijvend-kommanummer in Snowflake, kunnen deze fouten ertoe leiden dat onjuiste ID's naar de connector worden verzonden. Gebruik het gegevenstype NUMBER of gelijkwaardig voor ID's in Snowflake.
• U kunt een Snowflake-warehouse instellen op automatisch hervatten of opschorten. Raadpleeg de Snowflake-documentatie voor informatie over optimaal gebruik van deze voorzieningen.
• Het benoemde gegeven moet het identiteitstype Met naam genoemde hoofdpersoon gebruiken en de status Geauthenticeerd hebben.