Delen via

Dataverse

  • Artikel

Samenvatting

Item Beschrijving
Releasestatus Algemene beschikbaarheid
Producten Excel
Power BI (Semantische modellen)
Power BI (gegevensstromen)
Fabric (Dataflow Gen2)
Power Apps (gegevensstromen)
Dynamics 365 Customer Insights
Verificatietypen Organisatieaccount
Service-principal

Notitie

Het verificatietype van de service-principal wordt niet ondersteund bij het gebruik van een on-premises gegevensgateway of een VNet-gegevensgateway (virtueel netwerk).

Notitie

Sommige mogelijkheden zijn mogelijk aanwezig in één product, maar niet in andere vanwege implementatieschema's en hostspecifieke mogelijkheden.

Vereisten

U moet een Dataverse-omgeving hebben.

U moet leesmachtigingen hebben voor toegang tot gegevens in tabellen.

Als u de Dataverse-connector wilt gebruiken, moet de TDS-eindpuntinstelling zijn ingeschakeld in uw omgeving. Meer informatie: Functie-instellingen beheren

Als u de Dataverse-connector wilt gebruiken, moet een van de TCP-poorten 1433 of 5558 zijn geopend om verbinding te maken. Poort 1433 wordt automatisch gebruikt. Als poort 1433 echter wordt geblokkeerd, kunt u in plaats daarvan poort 5558 gebruiken. Als u poort 5558 wilt inschakelen, moet u dat poortnummer toevoegen aan de URL van de Dataverse-omgeving, zoals yourenvironmentid.crm.dynamics.com, 5558. Meer informatie: SQL Server-verbindingsprobleem vanwege gesloten poorten

Notitie

Als u Power BI Desktop gebruikt en poort 5558 moet gebruiken, moet u een bron maken met de URL van de Dataverse-omgeving, zoals yourenvironmentid.crm.dynamics.com.5558, in Power Query M. Meer informatie: De URL van uw Dataverse-omgeving zoeken

Ondersteunde mogelijkheden

  • Server-URL
  • Importeren
  • DirectQuery (semantische Power BI-modellen)
  • Geavanceerd
    • Relatiekolommen opnemen

Verbinding maken met Dataverse vanuit Power Query Desktop

Notitie

De Power Query Dataverse-connector is voornamelijk geschikt voor analyseworkloads, niet voor bulkgegevensextractie. Meer informatie: Alternatieve Dataverse-verbindingen

Verbinding maken met Dataverse vanuit Power Query Desktop:

  1. Selecteer de optie Dataverse in Gegevens ophalen. Meer informatie: Waar gegevens worden opgehaald

  2. Als u voor het eerst verbinding maakt met deze site, selecteert u Aanmelden en voert u uw referenties in . Selecteer vervolgens Connect.

    Meld u aan bij deze site.

  3. Selecteer in Navigator de gegevens die u nodig hebt en laad of transformeer de gegevens.

    Laden of transformeren vanuit navigator.

  4. Als u Power Query vanuit Power BI Desktop gebruikt, wordt u gevraagd om de modus Importeren of DirectQuery-gegevensconnectiviteit te selecteren. Selecteer vervolgens OK.

    Schermopname van de verbindingsinstellingen van Power BI Desktop met Importeren geselecteerd en DirectQuery niet geselecteerd.

Verbinding maken met Dataverse vanuit Power Query Online

Verbinding maken met Dataverse vanuit Power Query Online:

  1. Selecteer de optie Dataverse op de pagina Gegevensbron kiezen. Meer informatie: Waar gegevens worden opgehaald

  2. Laat op de pagina Verbinding maken met gegevensbron het URL-adres van de server leeg. Als u het adres leeg laat, worden alle beschikbare omgevingen weergegeven die u kunt gebruiken in het venster Power Query Navigator.

    Voer de server-URL in.

    Notitie

    Als u poort 5558 moet gebruiken om toegang te krijgen tot uw gegevens, moet u een specifieke omgeving laden met poort 5558 die aan het einde in het URL-adres van de server is toegevoegd. In dit geval gaat u naar de URL van uw Dataverse-omgeving zoeken voor instructies voor het verkrijgen van het juiste server-URL-adres.

  3. Voer indien nodig een on-premises gegevensgateway in als u on-premises gegevens gaat gebruiken. Als u bijvoorbeeld gegevens uit Dataverse en een on-premises SQL Server-database gaat combineren.

  4. Meld u aan bij uw organisatieaccount.

  5. Wanneer u bent aangemeld, selecteert u Volgende.

  6. Selecteer op de navigatiepagina de gegevens die u nodig hebt en selecteer vervolgens Gegevens transformeren.

    De navigatiepagina is geopend met de gegevens van de toepassingsgebruiker geselecteerd.

Verbinding maken met behulp van geavanceerde opties

Power Query Online biedt geavanceerde opties die u indien nodig aan uw query kunt toevoegen.

De volgende tabel bevat de geavanceerde opties die u kunt instellen in Power Query Online.

Geavanceerde optie Beschrijving
Relatiekolommen opnemen Indien ingeschakeld, bevat u kolommen met mogelijk relaties met andere tabellen. Als dit vak is uitgeschakeld, kunt u deze kolommen niet zien. Meer informatie: Prestatieproblemen met betrekking tot relatiekolommen

Zodra u de geavanceerde opties hebt geselecteerd die u nodig hebt, selecteert u Volgende om verbinding te maken met Dataverse.

De URL van uw Dataverse-omgeving zoeken

Als u poort 5558 moet gebruiken om verbinding te maken met Dataverse, moet u de URL van uw Dataverse-omgeving vinden. Open Power Apps. Selecteer in de rechterbovenhoek van de pagina Power Apps de omgeving waarmee u verbinding wilt maken. Selecteer het Pictogram Instellingen.instellingenpictogram en selecteer vervolgens Geavanceerde instellingen.

Kopieer op het nieuwe browsertabblad dat wordt geopend de hoofdmap van de URL. Deze hoofd-URL is de unieke URL voor uw omgeving. De URL heeft de indeling van https://< yourenvironmentid.crm.dynamics.com/>. Zorg ervoor dat u https:// en de volg-/url verwijdert voordat u deze plakt om verbinding te maken met uw omgeving. Voeg poort 5558 toe aan het einde van de omgevings-URL, bijvoorbeeld yourenvironmentid.crm.dyamics.com.5558.

Locatie van de URL van de Dataverse-omgeving.

Wanneer gebruikt u de Common Data Service-connector (verouderd)

Dataverse is de directe vervanging voor de Common Data Service-connector. Het kan echter voorkomen dat het nodig is om de Common Data Service-connector (verouderd) te kiezen in plaats van de Dataverse-connector :

Er zijn bepaalde TDS-gegevenstypen (Tabular Data Stream) die worden ondersteund in OData bij gebruik van Common Data Service (verouderd) die niet worden ondersteund in Dataverse. De ondersteunde en niet-ondersteunde gegevenstypen worden vermeld in Hoe Dataverse SQL verschilt van Transact-SQL.

Al deze functies worden in de toekomst toegevoegd aan de Dataverse-connector, waarna de Common Data Service-connector (verouderd) wordt afgeschaft.

Meer informatie: Toegang tot grote semantische modellen

Beperkingen en problemen

Specifieke Excel-host

De Power Query Dataverse-connector in Excel biedt momenteel geen ondersteuning voor onafhankelijke cloudclusters (bijvoorbeeld China, Duitsland, VS).

Dataverse-prestatie- en beperkingslimieten

Voor informatie over prestatie- en beperkingslimieten voor Dataverse-verbindingen gaat u naar Limieten en toewijzingen voor aanvragen. Deze beperkingen zijn van toepassing op zowel de Dataverse-connector als de OData-feedconnector bij het openen van hetzelfde eindpunt.

Tarief voor het ophalen van tabellen

Als richtlijn worden de meeste standaardtabellen opgehaald met een snelheid van ongeveer 500 rijen per seconde met behulp van de Dataverse-connector. Houd rekening met dit tarief bij het bepalen of u verbinding wilt maken met Dataverse of wilt exporteren naar data lake. Als u snellere ophaalsnelheden nodig hebt, kunt u overwegen om de functie Exporteren naar data lake of TDS-eindpunt (Tabular Data Stream) te gebruiken. Ga naar Alternatieve Dataverse-verbindingen voor meer informatie.

Alternatieve Dataverse-verbindingen

Er zijn verschillende alternatieve manieren om gegevens uit Dataverse te extraheren en te migreren:

  • Gebruik de azure Synapse Link-functie in Power Apps om gegevens uit Dataverse te extraheren naar Azure Data Lake Storage Gen2, die vervolgens kan worden gebruikt om analyses uit te voeren. Ga voor meer informatie over de functie Azure Synapse Link naar Wat is Azure Synapse Link voor Dataverse?

  • Gebruik de OData-connector om gegevens in en uit Dataverse te verplaatsen. Voor meer informatie over het migreren van gegevens tussen Dataverse-omgevingen met behulp van de OData-connector voor gegevensstromen gaat u naar Gegevens migreren tussen Dataverse-omgevingen met behulp van de OData-connector voor gegevensstromen.

Notitie

Zowel de Dataverse-connector als de OData-API's zijn bedoeld voor analytische scenario's waarbij gegevensvolumes relatief klein zijn. De aanbevolen benadering voor bulkgegevensextractie is 'Azure Synapse Link'.

Probleem met SQL Server-verbinding vanwege gesloten poorten

Wanneer u verbinding maakt met de Dataverse-connector, treedt er mogelijk een fout op die niet kan worden verbonden , wat aangeeft dat er een netwerk- of exemplaarspecifieke fout is opgetreden tijdens het tot stand brengen van een verbinding met SQL Server. Deze fout wordt waarschijnlijk veroorzaakt doordat de TCP-poorten 1433 of 5558 tijdens de verbinding worden geblokkeerd. Als u de fout met de geblokkeerde poort wilt oplossen, gaat u naar Geblokkeerde poorten.

Systeemeigen databasequery's gebruiken met Dataverse

U kunt verbinding maken met Dataverse met behulp van een aangepaste SQL-instructie of een systeemeigen databasequery. Hoewel er geen gebruikersinterface voor deze ervaring is, kunt u de query invoeren met behulp van de Power Query-Geavanceerde editor. Als u een systeemeigen databasequery wilt gebruiken, moet een database worden opgegeven als de bron.

Source = CommonDataService.Database([DATABASE URL])

Zodra een databasebron is gedefinieerd, kunt u een systeemeigen query opgeven met de functie Value.NativeQuery .

myQuery = Value.NativeQuery(Source, [QUERY], null, [EnableFolding=true])

De query ziet er helemaal als volgt uit.

let
    Source = CommonDataService.Database("[DATABASE]"),
    myQuery = Value.NativeQuery(Source, "[QUERY]", null, [EnableFolding=true])
in
    myQuery

Als u een kolomnaam verkeerd spelt, kan dit resulteren in een foutbericht over het vouwen van query's in plaats van ontbrekende kolom.

Toegang tot grote semantische modellen

Semantische Power BI-modellen in Dataverse kunnen erg groot zijn. Als u de Power Query Dataverse-connector gebruikt, heeft elke specifieke query die toegang heeft tot het model een time-out van vijf (5) minuten, ongeacht de grootte van de gegevens. Ga naar beperkingen voor meer informatie. U moet dus mogelijk meerdere keren query's uitvoeren op de gegevens om toegang te krijgen tot alle gegevens in het model. Het gebruik van meerdere query's kan veel tijd in beslag nemen om alle gegevens te retourneren.

Als u de Common Data Service-connector (verouderd) gebruikt, kunt u één query gebruiken om toegang te krijgen tot alle gegevens in het semantische model. Deze connector werkt anders en retourneert het resultaat in 'pagina's' van 5 K-records. Hoewel de Common Data Service-connector (verouderd) efficiënter is bij het retourneren van grote hoeveelheden gegevens, kan het nog steeds veel tijd duren om het resultaat te retourneren.

In plaats van deze connectors te gebruiken voor toegang tot grote semantische modellen, raden we u aan Azure Synapse Link te gebruiken voor toegang tot grote modellen. Het gebruik van Azure Synapse Link is nog efficiënter dan de Power Query Dataverse- of Common Data Service-connectors (verouderd) en is speciaal ontworpen voor scenario's voor gegevensintegratie.

Net als bij de SQL Server-connector is er een optie beschikbaar om navigatie-eigenschappen (relatiekolommen) in de Dataverse-connector uit te schakelen om de prestaties te verbeteren. Deze optie kan worden ingesteld in de geavanceerde opties die beschikbaar zijn in Power Query Online of kan worden ingesteld met behulp van de CreateNavigationProperties=false parameter in de functie Dataverse-connector.

 Source = CommonDataService.Database("{crminstance}.crm.dynamics.com",[CreateNavigationProperties=false]),