Azure Cosmos DB v2 (bèta)

Samenvatting

Item Beschrijving
Release-status Algemene beschikbaarheid
Producten Power BI (gegevenssets)
Ondersteunde verificatietypen Feedsleutel

Notitie

De Azure Cosmos DB V2-connector is vertraagd. We raden u aan om de V1-connector Azure Cosmos DB te blijven gebruiken.

Vereisten

Ondersteunde mogelijkheden

  • Importeren
  • DirectQuery

Verbinding maken met Azure Cosmos DB

Verbinding maken met Azure Cosmos DB gegevens:

  1. Start Power BI Desktop.

  2. Selecteer op het tabblad Start de optie Gegevens op halen.

  3. Voer in het zoekvak Cosmos DB v2 in.

  4. Selecteer Azure Cosmos DB v2 en selecteer vervolgens Verbinding maken.

    Selecteer Azure Cosmos DB v2.

  5. Voer op Azure Cosmos DB v2-verbindingspagina voor Cosmos-eindpunt de URI in van het Azure Cosmos DB-account dat u wilt gebruiken. Kies voor de modus Gegevensverbinding een modus die geschikt is voor uw gebruikscase, volgens de volgende algemene richtlijnen:

    • Kies Importeren voor kleinere gegevenssets. Wanneer u de importmodus gebruikt, Power BI met Cosmos DB om de inhoud van de volledige gegevensset te importeren voor gebruik in uw visualisaties.

      Notitie

      Als u de importmodus goed wilt instellen, moet u zowel de geavanceerde passdownmodus als de geavanceerde PBI-modus hebben ingesteld op 0. Meer informatie: Verbinding maken geavanceerde opties gebruiken

    • Kies DirectQuery voor grotere gegevenssets. In de DirectQuery-modus worden er geen gegevens gedownload naar uw werkstation. Tijdens het maken of gebruiken van een visualisatie, werkt Microsoft Power BI met Cosmos DB om dynamisch een query uit te voeren op de onderliggende gegevensbron, zodat u altijd de huidige gegevens bekijkt. Meer informatie: DirectQuery gebruiken in Power BI Desktop

      Notitie

      Als u de DirectQuery-modus goed wilt instellen, moet u zowel de geavanceerde passdownmodus als de geavanceerde PBI-modus instellen op 1. Meer informatie: Verbinding maken geavanceerde opties gebruiken

    Afbeelding van het dialoogvenster verbinding waarin de cosmos-eindpuntinvoer en de gegevensconnectiviteitsmodus zijn ingesteld op DirectQuery.

  6. Selecteer OK.

  7. Voer bij de prompt voor het configureren van verificatie van de gegevensbron de accountsleutel in. Selecteer vervolgens Connect.

    Kies een verificatiemethode.

    Uw gegevenscatalogus, databases en tabellen worden weergegeven in het dialoogvenster Navigator.

    In het dialoogvenster Navigator worden uw gegevens weergegeven.

  8. Schakel in het deelvenster Weergaveopties het selectievakje in voor de gegevensset die u wilt gebruiken.

  9. Als u de gegevensset wilt transformeren voordat u deze importeert, gaat u naar de onderkant van het dialoogvenster en selecteert u Gegevens transformeren. Met deze selectie wordt de Power Query editor geopend, zodat u de set gegevens die u wilt gebruiken kunt filteren en verfijnen. U kunt ook de connectoropties afstemmen door de doorgegeven argumenten te wijzigen.

    Verbindingsargumenten in Power Query editor.

  10. Selecteer anders Laden. Nadat het laden is voltooid, kunt u visualisaties maken. Als u DirectQuery hebt geselecteerd, Power BI u een query Cosmos DB voor de visualisatie die u hebt aangevraagd.

Verbinding maken geavanceerde opties gebruiken

Power Query Desktop biedt een set geavanceerde opties die u indien nodig aan uw query kunt toevoegen.

Voer verbindingsgegevens in.

De volgende tabel bevat alle geavanceerde opties die u kunt instellen in Power Query Desktop.

Geavanceerde optie Beschrijving
Aantal nieuwe proberen Hoe vaak moet u het opnieuw proberen als er HTTP-retourcodes 408 - Request Timeout van 412 - Precondition Failed , of 429 - Too Many Requests zijn? Het standaard aantal nieuwe proberen is 5.
Geavanceerde Passdown Probeer waar mogelijk door te geven. Stel in op 0 voor false of 1 voor true. De standaardwaarde is 1.
PBI-modus Geeft aan of het gedrag van het ODBC-stuurprogramma is afgestemd op de ondersteuning van de PBI-stroom. Stel in op 0 voor false of 1 voor true. De standaardwaarde is 1.
Protocoltype De indeling van de gegevens die worden uitgewisseld met Cosmos DB. Stel in op 0 voor tekst of 1 voor binaire gegevens. De standaardwaarde is 1.
Vlag die aangeeft of het verzamelingsschema expliciet wordt vermeld als een document Meer informatie: Schema in een document
Naam van de database die een schemadocument bevat, indien expliciet opgegeven Meer informatie: Schema in een document
Naam van de verzameling die een schemadocument bevat, indien expliciet opgegeven Meer informatie: Schema in een document
Naam van de JSON-eigenschap die moet worden gebruikt om het schemadocument op te zoeken Meer informatie: Schema in een document
Waarde van de JSON-eigenschap die moet worden gebruikt om het schemadocument op te zoeken Meer informatie: Schema in een document
Naam van de JSON-eigenschap in het schemadocument met het verzamelingsschema Meer informatie: Schema in een document
Vlag om aan te geven of er een fout moet worden opgetreden bij het sorteren van meer kolommen dan de samengestelde indexlimiet Detecteert of de doelverzameling een samengestelde index heeft die overeenkomt met de gesorteerde reeks kolommen. De standaardwaarde is 1 (true).
Vlag om aan te geven of ondersteunende ervaring moet worden gebruikt als er geen optimale samengestelde indexen zijn gedefinieerd voor Passdown sorteren Wanneer u een fout detecteert in de zes schemaopties in een document, vraagt u of de JSON van de definitie van de samengestelde index naar het klembord wordt gekopieerd. De inhoud van het klembord kan vervolgens worden in de definitie van de samengestelde index in de Cosmos DB-portal. Gebruik deze optie in de ontwikkelingsfase. De standaardwaarde is 0 (onwaar).
Vlag om aan te geven of alle velden in de sorteerclausule moeten worden doorgegeven Geeft aan of alle velden in de sorteerclausule moeten worden doorgegeven. Anders wordt alleen het veld dat is gesorteerd in Power BI rapport of het eerste veld dat is opgegeven in M, doorgegeven als optimalisatie. Sorteren is afhankelijk van de samengestelde indexen die voor de verzameling zijn gedefinieerd. Momenteel hebben Cosmos DB containers maximaal acht samengestelde indexen die kunnen worden gedefinieerd. De standaardwaarde is 0 (onwaar).
Rest API-versie Hiermee stelt REST API te gebruiken versie in. Mogelijke waarden zijn 2015-12-16 en 2018-12-31. De standaardwaarde is 2018-12-31. Deze waarde kan alleen worden ingesteld in een geavanceerde query.

Schema in een document

Notitie

Deze sectie bevat momenteel voorlopige informatie. Er wordt aanvullende informatie toegevoegd voordat de connector officieel wordt vrijgegeven.

Vlag die aangeeft of het verzamelingsschema expliciet wordt vermeld als een document (standaard 0, dat wil zeggen, geen schema als document)

Voorbeeld van gebruik

  • Naam van de database die een schemadocument bevat, indien expliciet opgegeven
  • Naam van de verzameling die een schemadocument bevat, indien expliciet opgegeven
  • Naam van de JSON-eigenschap die moet worden gebruikt om het schemadocument op te zoeken
  • Waarde van de JSON-eigenschap die moet worden gebruikt om het schemadocument op te zoeken
  • Naam van de JSON-eigenschap in het schemadocument met het verzamelingsschema

Instructies, beperkingen en bekende problemen

U moet rekening houden met de volgende instructies, beperkingen en bekende problemen met betrekking tot toegang tot de huidige versie van Azure Cosmos DB v2-gegevens.

Instructies

  • Wanneer u deze connector in de importmodus gebruikt, stelt u zowel Geavanceerde passdown- als PBI-modus in op 0 (ADVANCED_PASSDOWN="0", PBI_MODE="0").
  • Publiceer geen rapporten op Power BI service die de modus Rapportontwikkelaar is ingeschakeld (REPORT_DEVELOPER_MODE_ON ="1").
  • Gebruik de volgende best practices bij het werken met nieuwe grote verzamelingen in de DirectQuery-modus:
    • Schakel de modus rapportontwikkelaar () tijdelijk REPORT_DEVELOPER_MODE_ON="1" in. Als u deze modus inschakelen, kan de gegevensindeling worden gevonden door een zeer kleine gegevensset uit Cosmos DB.
    • Zodra de verzameling is voorbereid met de benodigde samengestelde indexen en de nuttige data engineering-aspecten met betrekking tot de gegevensvormen zijn vastgesteld, kunt u teruggaan naar de normale modus ( ) en de Data Engineering-activiteiten starten die zijn gericht op de gegevenssets in zijn REPORT_DEVELOPER_MODE_ON="0" geheel.

Beperkingen

  • Rapporten moeten worden gefilterd op partitiesleutels die zijn gedefinieerd op de onderliggende Cosmos DB Container.
  • Als u wilt sorteren op meer dan één kolom ( ), moet u er rekening mee houden dat de sortering wordt gedelegeerd aan Cosmos DB, die niet sorteert op velden die geen deel uitmaken van samengestelde FULL_SORTING_ON="1" indexen.
  • Om te helpen bij het maken van de benodigde samengestelde indexen tijdens het ontwerpen van het rapport in PBI Desktop, moet de rapportontwikkelaarsmodus zijn ingeschakeld ( ), waarmee wordt gevraagd om de JSON-tekst te kopiëren naar klembord die in de Cosmos DB-portal kan worden gepijzeld bij het opgeven van de samengestelde index van de REPORT_DEVELOPER_MODE_ON="1" Cosmos DB-verzameling.

Bekende problemen in de DirectQuery-modus

  • Rapporten met meer dan acht kolommen werken niet in de DirectQuery-modus.
  • Statistische functies worden niet doorgegeven. Het effect is dat SQL expressies voor Down COUNT, SUM, e.a., mislukken en geen getal weergeven.