Stjerne sikret med Ettra-id

Bemærkning

Starburst ejer og leverer denne connector.

Denne artikel dokumenterer Starburst, der er beskyttet af Entra ID (DataSourceKind: StarburstAad). Den oprindelige Starburst-connector (DataSourceKind: StarburstPresto) er også tilgængelig. Se Starburst.

Resumé

Egenskab Værdi
Connector Stjerne sikret med Entra ID ikon Stjerne sikret af Entra ID
Produkter Power BI (semantiske modeller)
Power Query Online
Frigivelse tilstand Generel tilgængelighed
Kategori Anden
Godkendelsestyper Adgangstoken (JWT)
Entra-id
Adgangskode
Datakildetype StarburstAad
Dokumentation til funktionsreference StarburstAad.Contents
Supportlink Støtte

Bemærkning

Nogle kapabiliteter kan være til stede i ét produkt, men ikke i andre, på grund af udrulningsplaner og værtsspecifikke funktioner.

Forudsætninger

  • Den nyeste version af Power BI Desktop. Microsoft føjede den oprindelige Starburst-connector til Power BI Desktop i oktober 2023, så alle versioner fra den pågældende dato inkluderer den. Brug altid den nyeste Power BI Desktop-udgave for at få opdaterede stik.
  • Starburst ODBC-driveren, installeret på samme computer som Power BI Desktop. Version 3-driveren anbefales. Hvis du bruger version 2-driveren, skal den være 2.0.15.1021 eller nyere.
  • Til Power Query Online eller opdatering i Power BI-tjeneste, en lokal datagateway med Starburst ODBC-driveren installeret på gateway-computeren.

Understøttede funktioner

  • Importér
  • DirectQuery (Power BI semantiske modeller)
  • Microsoft Entra ID enkeltlogon (SSO) til DirectQuery (Starburst er kun sikret med Entra ID connector)
  • Native (tilpassede) SQL-forespørgsler
  • Avancerede forbindelsesmuligheder:
    • Rolle
    • Katalog
    • Brug systemproxy
    • Forbindelsesstreng
    • Oprindelig forespørgsel

Parametre

Indgangspunkt:StarburstAad.Contents

Obligatorisk parameterantal: 2

Parameter Vist navn Required Type Gruppe Beskrivelse Stikprøveværdier Nullable
Vært Vært Yes sende sms Værtsnavnet på Starburst-serveren. "starburst.mydomain.com, mydomain-cluster.trino.galaxy.starburst.io" false
Port Port Yes nummer Den port, som serveren kører på. 443 false
muligheder Avancerede indstillinger No Annullerbar registrering Avancerede indstillinger sand

Felter i options

Felt Vist navn Required Type Gruppe Beskrivelse Erklæret standard Tilladte værdier Stikprøveværdier Nullable Valgfrit Deklarerede tilladte værdier
indstillinger. Rolle Rolle No sende sms Avancerede indstillinger Angiv systemrollen. "" "offentlig" false sand
indstillinger. Katalog Katalog No sende sms Avancerede indstillinger Angiv et katalognavn for at aktivere oprindelige forespørgsler eller for at begrænse dialogboksen Navigator til kun at indlæse objekter fra ét katalog. "" "tpch" false sand
indstillinger. UseSystemProxy Brug systemproxy No sende sms Avancerede indstillinger Når indstillingen er aktiveret, bruges systemproxyindstillinger (hvis de er defineret). "Nej (standard)"; "Ja" false sand ["Nej (standard)", "Ja"]
indstillinger. Ekstra forbindelsesstreng Forbindelsesstreng (egenskaber uden legitimationsoplysninger) No sende sms Avancerede indstillinger Kun for egenskaber, der ikke er legitimationsoplysninger. Brug dialogboksen med legitimationsoplysninger til at angive sikkerhedsrelaterede egenskaber, f.eks. Brugernavn og Adgangskode. "" "AllowSelfSignedServerCert=1; Min_TLS=1,2" false sand

Opret forbindelse fra Power Query Desktop

  1. Fra Hjem-båndet vælger du Get Data. StarburstSøg efter , vælg den connector, der er dokumenteret i denne artikel, og vælg derefter Opret forbindelse'. Du kan få flere oplysninger under Vælg, hvilken Starburst-connector der skal bruges.

  2. I forbindelsesdialogboksen skal du angive din Starburst-klyngevært og port'. For Starburst Galaxy skal OAuth-referencestrengen tilføjes til værtsnavnet, som dokumenteret af Starburst.

  3. Udvid valgfrit Avancerede indstillinger og sæt en af Rolle, Katalog,Brug systemproxy, Forbindelsesstreng eller Native forespørgsel.

  4. Vælg DirectQuery eller Import for dataforbindelsestilstand, og vælg derefter OK.

  5. Vælg en autentificeringstype, indtast dine legitimationsoplysninger, og vælg Forbind.

  6. I Navigator vælger du de kataloger og tabeller, du ønsker, og vælger derefter Indlæs eller Transformér data.

Opret forbindelse fra Power Query Online

For Power Query Online forbinder du via den lokale datagateway.

  1. Fra Power BI-tjeneste eller Fabric vælger du Indstillinger>Administrer forbindelser og gateways, og vælg derefter + Ny.

  2. Vælg On-premises og gateway-klyngen, der har Starburst ODBC-driveren installeret.

  3. Vælg den connector, der er dokumenteret i denne artikel, for Forbindelsestype.

  4. Indtast forbindelsesoplysninger og godkendelsesoplysninger, og vælg derefter Opret dem.

  5. Kortlæg din semantiske models datakilde til den nye forbindelse i datasættets indstillinger.

Flere oplysninger

Vælg, hvilken connector der skal bruges

To Starburst-stik vises i dialogen Get Data :

Skærmbillede af hent data-dialogen, der viser både Starburst-stikket og Starburst-forbindelsen sikret med Entra ID-stik.

Tip

Eksisterende rapporter, der bruger den originale Starburst-connector, behøver ikke at migrere. Skift til Starburst sikret af Entra ID kun hvis du har brug for Entra ID SSO.

Godkendelse

Starburst, der er sikret af Entra ID connector, understøtter disse godkendelsestyper. Vælg den type, der matcher, hvordan din Starburst-klynge er konfigureret:

Kerberos

Kerberos-godkendelse er tilgængelig i den oprindelige Starburst-connector, ikke i Starburst, der er sikret af Entra ID.

Adgangskode

Vælg Basic som autentificeringstype og indtast dit Starburst-brugernavn og adgangskode. Klyngen skal konfigureres til at acceptere adgangskodeautentificering.

Adgangstoken

Vælg Web API som autentificeringstype og indsæt en personlig JSON Web Token (JWT), udstedt af din Starburst-administrator. Klyngen skal konfigureres til at acceptere JWT-autentificering.

OAuth 2.0

Generisk OAuth 2.0-godkendelse er tilgængelig i den oprindelige Starburst-connector. Brug Microsoft Entra ID til denne connector.

Microsoft Entra ID

Denne godkendelsestype er kun tilgængelig i starburst, der er sikret af Entra ID connector. Hvis du vil have mere at vide om konfiguration og forudsætninger, skal du se Aktivér Microsoft Entra ID enkeltlogon til DirectQuery.

Aktivér Microsoft Entra ID enkeltlogon for DirectQuery

Når du aktiverer Microsoft Entra ID enkeltlogon (SSO) for starburst, der er beskyttet af Entra ID connector, godkendes seerne af en Semantisk DirectQuery-model til Starburst med deres egen Microsoft Entra ID identitet. Starbursts dataadgangspolitikker, herunder sikkerhed på række- og kolonneniveau, gælder derefter for selve rapportvisningen i stedet for for en delt forbindelseskonto.

Hvornår skal man bruge Entra ID SSO

Brug Entra ID SSO når:

  • Du ønsker, at Starbursts dataadgangspolitikker, række-niveau sikkerhed eller kolonne-niveau sikkerhed gælder for rapportviseren i DirectQuery-tilstand.
  • Revisions- eller overholdelsesregler forbyder en delt forbindelseslegitimation for alle brugere.
  • Du vil fjerne de Active Directory i det lokale miljø- og Kerberos-begrænsede delegeringsafhængigheder, som Kerberos SSO kræver.

Entra ID SSO gælder kun for DirectQuery. Importmodeller besvarer forespørgsler fra importerede data og videresender ikke brugeridentiteter til Starburst.

Sådan fungerer det

Når en viser åbner en DirectQuery-rapport, videresender den semantiske model brugerens Entra ID-token til den lokale datagateway. Gatewayen sender tokenet videre til Starburst, og Starburst validerer tokenet direkte med Microsoft Entra ID. Starburst anvender derefter sine egne autorisationspolitikker på den autentificerede bruger.

SSO-forudsætninger

  • Starburst-klyngen er konfigureret til at acceptere OAuth 2.0-tokens udstedt af Microsoft Entra ID. For opsætningsinstruktioner, se afsnittet Entra ID i dokumentationen Starburst.
  • Den lokale datagateway er på en udgivelse, der understøtter Entra ID SSO.
  • En Power BI-lejeradministrator aktiverer de to lejerindstillinger, der er beskrevet i næste afsnit.

Aktivér lejerindstillingerne

En Power BI-lejeradministrator slår to indstillinger til i Power BI-administrationsportalen. Begge indstillinger er påkrævet.

  1. Slå Starburst SSO til. Denne indstilling styrer, om afkrydsningsboksen Brug SSO via Azure AD for DirectQuery vises for Starburst sikret af Entra ID datakilder.

  2. Tænd Microsoft Entra single sign-on for datagateway. Denne indstilling er en forudsætning for enhver Entra ID-baseret SSO via en datagateway. Uden den forbliver Starburst SSO-afkrydsningsboksen deaktiveret.

Skærmbillede af Power BI admin-portalen med Aktiver Starburst SSO og Microsoft Entra single sign-on for datagateway begge aktiveret.

Aktivér SSO på datakilden

Når lejerindstillingerne er slået til, konfigurer du indstillingen pr. forbindelse:

  1. I Manage forbindelser og gateways åbn Starburst, som er sikret af Entra ID datakilden.

  2. Under Single sign-on vælg Brug SSO via Azure AD for DirectQuery-forespørgsler.

  3. Gem datakilden.

Skærmbillede af Starburst, sikret ved Entra ID datakildeindstillinger, med afkrydsningsboksen Brug SSO via Azure AD for DirectQuery-forespørgsler.

Enhver DirectQuery-semantisk model, der er bundet til denne dataforbindelse, videresender nu hver seers Entra ID-token til Starburst.

Begrænsninger og overvejelser

  • Entra ID SSO gælder kun for DirectQuery. Importerede semantiske modeller videresender ikke viewer-identiteter til Starburst.
  • Entra ID autentificering er kun tilgængelig i Starburst, der er sikret med Entra ID-connectoren.
  • Eksisterende semantiske modeller, der bruger den oprindelige Starburst-connector, fortsætter med at fungere og behøver ikke at migrere.