Snowflake
In dit artikel wordt beschreven hoe u Tableau verbindt met een Snowflake-datawarehouse en de databron instelt.
Voordat u begint
Verzamel de volgende verbindingsinformatie voordat u begint:
- Naam van de server waarmee u verbinding wilt maken
- Verificatiemethode:
- OAuth: gebruik deze methode als u federatie vanuit een IDP wilt inschakelen.
- SAML IDP: gebruik deze methode als u de IDP-referenties in de verbinding wilt insluiten.
- Gebruikersnaam en wachtwoord: gebruik deze methode als u gebruikersreferenties in Snowflake wilt opslaan.
- De aanmeldreferenties zijn afhankelijk van de verificatiemethode die u kiest
- (Optioneel) Initiële SQL-statement die elke keer wordt uitgevoerd wanneer Tableau verbinding maakt
Stuurprogramma vereist
Voor deze connectors is een stuurprogramma vereist om met de database te communiceren. Mogelijk is het vereiste stuurprogramma al op uw computer geïnstalleerd. Als het stuurprogramma niet op uw computer is geïnstalleerd, geeft Tableau in het verbindingsdialoogvenster een bericht weer met een koppeling naar de pagina Stuurprogramma downloaden(Link wordt in een nieuw venster geopend), waar u stuurprogrammalinks en installatie-instructies kunt vinden.
Opmerking: om OAuth met Snowflake te kunnen gebruiken, moet u versie 2.25.4 of een recentere versie van een ODBC-stuurprogramma van Snowflake installeren.
De verbinding maken en de databron instellen
Nadat u Snowflake als uw verbinding hebt geselecteerd, wordt er een pop-upmenu getoond met drie tabbladen. Gebruik het tabblad Algemeen voor verificatie. U kunt de Initiële SQL ook gebruiken om aan het begin van elke verbinding een SQL-opdracht uit te voeren. Zie Initiële SQL uitvoeren voor meer informatie. U kunt het tabblad Geavanceerd gebruiken om klantverbindingen met parameters toe te voegen.
Tableau verbinden met uw data
- Start Tableau en selecteer onder Verbinding maken de optie Snowflake.
- Voer de naam in van de server waarmee u verbinding wilt maken.
- Selecteer de verificatiemethode: Gebruikersnaam en wachtwoord, Okta-gebruikersnaam en -wachtwoord of Aanmelden met OAuth.
- Selecteer een van de verificatiemethoden en voltooi de stappen voor het inloggen.
Okta-gebruikersnaam en -wachtwoord:
- Voer de Gebruikersnaam en het Wachtwoord in.
- Voer in het veld Okta de URL in voor de Okta-server.
Aanmelden met OAuth
- (Optioneel) Selecteer Initiële SQL als u aan het begin van elke verbinding een SQL-opdracht wilt uitvoeren. Zie Initiële SQL uitvoeren voor meer informatie.
- Selecteer Aanmelden.
- Op de webpagina die wordt geopend logt u in bij Snowflake door uw Gebruikersnaam en Wachtwoord in te voeren en vervolgens Inloggen te selecteren. Of selecteer Eenmalige aanmelding als Snowflake is geconfigureerd om SSO te ondersteunen.
- Klik op OK om te bevestigen dat u toestemming hebt voor toegang tot uw Snowflake-data.
- Sluit het browservenster en Tableau.
- Ga naar de volgende sectie: 'De databron instellen'.
- Selecteer Aanmelden.
Als Tableau de verbinding niet tot stand kan brengen, controleer dan of uw referenties kloppen. Als u nog steeds geen verbinding kunt maken, heeft uw computer problemen met het lokaliseren van de server. Neem contact op met uw netwerkbeheerder of databasebeheerder.
Time-out van toegangstoken: valideer altijd de TDC van het toegangstoken
Het Snowflake-toegangstoken verloopt na 10 minuten. Bij bepaalde processen voor extractvernieuwing worden later in de taak nieuwe verbindingen tot stand gebracht, wanneer het toegangstoken al is verlopen. Om dit probleem aan te pakken, hebben we een nieuwe functionaliteit toegevoegd. Deze is vanaf Tableau 2024.2 standaard ingeschakeld. Om deze mogelijkheid in oudere versies in te schakelen, kunt u de volgende TDC gebruiken.
<connection-customization class='snowflake' enabled='true' version='10.0'>
<vendor name='snowflake' />
<driver name='snowflake' />
<customizations>
<customization name='CAP_OAUTH_VALIDATE_ALWAYS' value='yes'/>
</customizations>
</connection-customization>
Als u Tableau Cloud gebruikt, kunt u publiceren vanuit Tableau Desktop door de TDC te installeren in de map Databronnen van de Tableau-opslagplaats. Hiermee wordt de TDC bij publicatie in de werkmap of databron ingesloten.
De ingesloten TDC wordt altijd toegepast, ongeacht de status van de ingeschakelde markering en zolang er geen andere TDC op de server is geïnstalleerd. En er wordt nooit een TDC geïnstalleerd op Tableau Cloud (alleen ingesloten).
Opmerking: ingesloten TDC's worden niet ondersteund met flows.
De verbinding aanpassen met stuurprogrammaparameters
U kunt de verbinding die met de Snowflake-connector is gemaakt, wijzigen door op het tabblad Geavanceerd stuurprogrammaparameters toe te voegen aan de verbindingsreeks.
Opmerking: u kunt de door Tableau gegenereerde stuurprogrammaparameters niet wijzigen. U kunt alleen parameters toevoegen.
Deze syntaxis geeft bijvoorbeeld een proxyserver aan die moet worden gebruikt wanneer de waarden no_proxy
niet worden gehaald en hostnamen de proxyserver mogen omzeilen:
Proxy=http://proxyserver.company:80;no_proxy=.trustedserver.com;
Zie Een proxy voor Snowflake gebruiken voor een ander voorbeeld van aangepaste stuurprogrammaparameters.
Opmerking: als u aanpassingen wilt doorvoeren zonder deze in de databron in te sluiten, kunt u parameters configureren in het register op Windows (alleen parameters die zijn gemarkeerd als 'Configuratieparameters' zijn beschikbaar). Zie ODBC-configuratie en verbindingsparameters op de Snowflake-website voor meer informatie over stuurprogrammaparameters.
De databron instellen
Op de pagina Databron doet u het volgende:
(Optioneel) Selecteer de standaard databronnaam boven aan de pagina en voer vervolgens een unieke databronnaam in voor gebruik in Tableau. Gebruik bijvoorbeeld een naamgevingsconventie voor databronnen waarmee andere gebruikers van de databron kunnen bepalen met welke databron ze verbinding moeten maken.
- Selecteer uit de vervolgkeuzelijst Warehouse het warehouse of gebruik het tekstvak om op naam naar een warehouse te zoeken.
Opmerking: als u dit leeg laat en geen warehouse selecteert, gebruikt Tableau uw standaard virtuele Snowflake-warehouse.
Zie Standaard virtuele warehouses in Snowflake voor meer informatie.
- Selecteer uit de vervolgkeuzelijst Database een database en open deze. Of gebruik het tekstvak om op naam naar een database te zoeken.
- Selecteer uit de vervolgkeuzelijst Schema een schema of gebruik het tekstvak om op naam naar een schema te zoeken.
- Selecteer onder Tabel een tabel of gebruik het tekstvak om op naam naar een tabel te zoeken.
Sleep een tabel naar het canvas en selecteer vervolgens het tabblad Blad om uw analyse te starten.
Aanmelden op een Mac
Als u Tableau Desktop op een Mac gebruikt, moet u bij het invoeren van de servernaam om verbinding te maken een volledig gekwalificeerde domeinnaam gebruiken, zoals mydb.test.ourdomain.lan, in plaats van een relatieve domeinnaam, zoals mydb of mydb.test.
U kunt het domein ook toevoegen aan de lijst met zoekdomeinen voor de Mac-computer. Wanneer u dan verbinding maakt, hoeft u alleen de servernaam op te geven. Als u de lijst met zoekdomeinen wilt bijwerken, gaat u naar Systeemvoorkeuren > Netwerk > Geavanceerd en opent u het tabblad DNS.
Standaard virtuele warehouses in Snowflake
Wanneer u een Snowflake-databron maakt, maakt u een Snowflake-warehouse (voor rekenhulpbronnen) en Snowflake-databases (voor datahulpbronnen). Voor toegang tot warehouses en databases zijn machtigingen vereist. U kunt verschillende warehouses gebruiken voor toegang tot dezelfde database, afhankelijk van de rekenkracht die u nodig hebt. Hierbij geldt wel dat u voor elk warehouse en elke database de juiste machtigingen dient te hebben.
Wanneer u een databron maakt, kunt u een warehouse selecteren uit een vervolgkeuzelijst. Als u dit leeg laat en geen warehouse selecteert, gebruikt Tableau uw standaard virtuele Snowflake-warehouse. Als u die databron of werkmap vervolgens publiceert, gebruikt Tableau de standaard virtuele Snowflake-warehouse van die persoon wanneer deze verbinding maakt.
Aan elke gebruiker moet een standaardwarehouse zijn toegewezen, zodat Tableau deze als standaardwarehouse kan gebruiken om een werkmap te openen vanuit een Snowflake-databron.
Snowflake-serverondersteuning configureren voor OAuth
Zie OAuth configureren voor Snowflake-verbindingen(Link wordt in een nieuw venster geopend) voor informatie over het configureren van OAuth voor verbindingen tussen Tableau en Snowflake.
Een proxy voor Snowflake gebruiken
U kunt vanuit Tableau via een proxy verbinding maken met Snowflake. Als u Tableau versie 2019.4 of hoger gebruikt, kunt u deze configureren met het dialoogvenster Connector door de vereiste parameters in te typen op het tabblad Geavanceerd.
Bijvoorbeeld:
proxy=http://proxyserver.company:80
Zie de Snowflake-documentatie(Link wordt in een nieuw venster geopend) voor informatie over de parameters die u moet gebruiken.
Opmerking: Tableau gebruikt geen DSN om verbinding te maken met Snowflake. U kunt de instructies in de Snowflake-documentatie over het gebruik van een DSN dus negeren.
Als u een versie van Tableau van vóór 2019.4 gebruikt, kunt u deze configureren door de parameters in een TDC-bestand in te voeren met odbc-extras
.
Bijvoorbeeld:
<connection-customization class='snowflake' enabled='true' version='19.1'>
<vendor name='snowflake' />
<driver name='snowflake' />
<customizations>
<customization name='odbc-connect-string-extras' value='proxy=http://proxyserver.company:80' />
</customizations></connection-customization>
Zie het artikel De verbindingsreeks voor een systeemeigen connector aanpassen(Link wordt in een nieuw venster geopend) voor meer informatie.
Problemen oplossen
Prestaties
Gebruik de volgende informatie om eventuele prestatieproblemen op te lossen die u ondervindt bij het gebruik van Tableau met Snowflake.
Formaat ophalen
Bij gebruik van niet-gebonden VARCHAR- of VARBINARY-velden retourneert het stuurprogramma de veldgrootte als 16 M. Hierdoor gebruikt Tableau een kleine ophaalgrootte om binnen de geheugenlimieten te blijven. Dit resulteert in een lage querysnelheid. Er zijn verschillende manieren om dit aan te pakken.
Schemawijzigingen
Als u een grootte toevoegt aan de kolomdefinitie, bijvoorbeeld VARCHAR(256), kan Tableau de optimale ophaalgrootte berekenen.
TDC-aanpassingen
U kunt de stuurprogrammaparameters default_varchar_size of default_binary_size gebruiken. U kunt ook (https://docs.snowflake.com/en/developer-guide/odbc/od
bc-parameters) gebruiken om een maximale veldgrootte voor niet-gebonden velden in te stellen.
U kunt de geavanceerde gebruikersinterface of een TDC gebruiken.
U moet ook een extra mogelijkheid instellen: CAP_ODBC_FETCH_BUFFERS_RESIZABLE.
Opmerking: deze oplossing werkt niet voor Tableau Cloud, tenzij u Tableau Bridge gebruikt.
Als u Tableau Bridge gebruikt, kunt u de TDC op de Bridge-host installeren, zodat deze wordt toegepast op alle verbindingen die via die host lopen. Zie hieronder enkele voorbeelden.
Gebruik deze TDC als u van plan bent de veldgrootte voor elke databron aan te passen met de voorgaande gebruikersinterface.
<connection-customization class='snowflake' enabled='true' version='10.0'>
<vendor name='snowflake' />
<driver name='snowflake' />
<customizations>
<customization name='CAP_ODBC_FETCH_BUFFERS_RESIZABLE' value='yes'/>
</customizations>
</connection-customization>
Gebruik deze TDC om de aanpassingen voor alle databronnen toe te passen.
<connection-customization class='snowflake' enabled='true' version='10.0'>
<vendor name='snowflake' />
<driver name='snowflake' />
<customizations>
<customization name='CAP_ODBC_FETCH_BUFFERS_RESIZABLE' value='yes'/>
<customization name='odbc-connect-string-extras' value='default_varchar_size=512;default_binary_size=512'/>
</customizations>
</connection-customization>
Veelgestelde vragen
Hier zijn enkele veelvoorkomende problemen en stappen om deze op te lossen.
Ik krijg de foutmelding 'Dit veld XXX bestaat niet'. Wat moet ik doen?
Deze fout treedt op wanneer u een berekend veld gebruikt, het toevoegt aan het werkblad en de databron vervangt door de Snowflake-data (CustomSQL).
Gebruik de functie Veldverwijzingen vervangen om de fout op te lossen. Zie Veldverwijzingen vervangen voor aanvullende informatie over het vervangen van veldverwijzingen.
- Best practices voor het gebruik van Tableau met Snowflake(Link wordt in een nieuw venster geopend) op de Snowflake-website (registratie vereist).
Zie ook
- Databronnen instellen – Voeg meer data toe aan deze databron of bereid de data voor voordat u deze analyseert.
- Diagrammen maken en data analyseren – Begin met de data-analyse.