Partager via

Datasets - Get Dataset

  • Référence
Service:
Power BI REST APIs
Version d'API:
v1.0

Retourne le jeu de données spécifié à partir de Mon espace de travail.

Étendue requise

Dataset.ReadWrite.All ou Dataset.Read.All 

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}

Paramètres URI

Nom Dans Obligatoire Type Description
datasetId
 path True

string

ID du jeu de données

Réponses

Nom Type Description
200 OK

Dataset

D’ACCORD

Exemples

Example

Exemple de requête

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229

Exemple de réponse

Code d’état:
200 
{
  "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "name": "SalesMarketing",
  "addRowsAPIEnabled": false,
  "configuredBy": "john@contoso.com",
  "isRefreshable": true,
  "isEffectiveIdentityRequired": true,
  "isEffectiveIdentityRolesRequired": true,
  "isOnPremGatewayRequired": false
}

Définitions

Nom Description
Dataset

Jeu de données Power BI. L’API retourne un sous-ensemble de la liste suivante des propriétés du jeu de données. Le sous-ensemble dépend de l’API appelée, des autorisations d’appelant et de la disponibilité des données dans la base de données Power BI.
DatasetQueryScaleOutSettings

Interroger les paramètres de scale-out d’un jeu de données
DatasetUser

Entrée de droit d’accès utilisateur Power BI pour un jeu de données
DatasetUserAccessRight

Droit d’accès que l’utilisateur a pour le jeu de données (niveau d’autorisation)
DependentDataflow

Flux de données dépendant de Power BI
Encryption

Informations de chiffrement pour un jeu de données
EncryptionStatus

État du chiffrement du jeu de données
PrincipalType

Type de principal
ServicePrincipalProfile

Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.

Dataset

Object

Jeu de données Power BI. L’API retourne un sous-ensemble de la liste suivante des propriétés du jeu de données. Le sous-ensemble dépend de l’API appelée, des autorisations d’appelant et de la disponibilité des données dans la base de données Power BI.

Nom Type Description
ContentProviderType

string

Propriété déconseillée qui doit être ignorée.
Encryption

Encryption

Informations de chiffrement du jeu de données. Applicable uniquement lorsque $expand est spécifié.
IsEffectiveIdentityRequired

boolean

Indique si le jeu de données nécessite une identité effective, que vous devez envoyer dans un appel d’API GenerateToken.
IsEffectiveIdentityRolesRequired

boolean

Indique si la sécurité au niveau des lignes est définie à l’intérieur du fichier .pbix Power BI. Dans ce cas, vous devez spécifier un rôle.
IsInPlaceSharingEnabled

boolean

Indique si le jeu de données peut être partagé avec des utilisateurs externes à consommer dans leur propre locataire
IsOnPremGatewayRequired

boolean

Indique si le jeu de données nécessite une passerelle de données locale
IsRefreshable

boolean

Ce champ retourne true lorsque le jeu de données est récemment actualisé ou configuré pour l’actualisation automatique, avec le mode de connexion spécifiquement défini sur « Importer ». La valeur retourne false pour d’autres modes de connexion, tels que « DirectQuery » et « LiveConnection », que le jeu de données soit actualisé manuellement ou configuré pour l’actualisation automatique.
addRowsAPIEnabled

boolean

Indique si le jeu de données autorise l’ajout de nouvelles lignes
configuredBy

string

Propriétaire du jeu de données
createReportEmbedURL

string

Le jeu de données crée une URL d’incorporation de rapport
createdDate

string (date-time)

Date et heure de création du jeu de données
description

string

Description du jeu de données
id

string

ID du jeu de données
name

string

Nom du jeu de données
qnaEmbedURL

string

Le jeu de données Q&UNE URL incorporée
queryScaleOutSettings

DatasetQueryScaleOutSettings

Interroger les paramètres de scale-out d’un jeu de données
targetStorageMode

string

Mode de stockage du jeu de données
upstreamDataflows

DependentDataflow[]

La liste de tous les flux de données dont dépend cet élément
users

DatasetUser[]

(Valeur vide) Détails de l’accès de l’utilisateur au jeu de données. Cette propriété sera supprimée de la réponse de charge utile dans une prochaine version. Vous pouvez récupérer des informations utilisateur sur un élément Power BI (tel qu’un rapport ou un tableau de bord) à l’aide du Obtenir des utilisateurs de jeu de données en tant qu’API d’administration, ou de l’API PostWorkspaceInfo avec le paramètre getArtifactUsers.
webUrl

string

URL web du jeu de données

DatasetQueryScaleOutSettings

Object

Interroger les paramètres de scale-out d’un jeu de données

Nom Type Description
autoSyncReadOnlyReplicas

boolean

Indique si le jeu de données synchronise automatiquement les réplicas en lecture seule
maxReadOnlyReplicas

integer

minimum: -1
maximum: 64

Nombre maximal de réplicas en lecture seule pour le jeu de données (0-64, -1 pour le nombre automatique de réplicas)

DatasetUser

Object

Entrée de droit d’accès utilisateur Power BI pour un jeu de données

Nom Type Description
datasetUserAccessRight

DatasetUserAccessRight

Droit d’accès que l’utilisateur a pour le jeu de données (niveau d’autorisation)
displayName

string

Nom complet du principal
emailAddress

string

Adresse e-mail de l’utilisateur
graphId

string

Identificateur du principal dans Microsoft Graph. Disponible uniquement pour les API d’administration.
identifier

string

Identificateur du principal
principalType

PrincipalType

Type de principal
profile

ServicePrincipalProfile

Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.
userType

string

Type de l’utilisateur.

DatasetUserAccessRight

Énumération

Droit d’accès que l’utilisateur a pour le jeu de données (niveau d’autorisation)

Valeur Description
None

Supprime l’autorisation du contenu dans le jeu de données
Read

Octroie l’accès en lecture au contenu dans le jeu de données
ReadExplore

Octroie l’accès en lecture et explorer au contenu du jeu de données
ReadReshare

Accorde l’accès en lecture et repartage au contenu du jeu de données
ReadReshareExplore

Accorde l’accès en lecture, repartage et exploration du contenu dans le jeu de données
ReadWrite

Octroie l’accès en lecture et écriture au contenu du jeu de données
ReadWriteExplore

Accorde l’accès en lecture, écriture et exploration au contenu du jeu de données
ReadWriteReshare

Accorde l’accès en lecture, écriture et partage à nouveau au contenu du jeu de données
ReadWriteReshareExplore

Accorde l’accès en lecture, écriture, partage et exploration du contenu dans le jeu de données

DependentDataflow

Object

Flux de données dépendant de Power BI

Nom Type Description
groupId

string

ID de groupe cible
targetDataflowId

string

ID de flux de données cible

Encryption

Object

Informations de chiffrement pour un jeu de données

Nom Type Description
EncryptionStatus

EncryptionStatus

État du chiffrement du jeu de données

EncryptionStatus

Énumération

État du chiffrement du jeu de données

Valeur Description
InSyncWithWorkspace

Le chiffrement est pris en charge et est synchronisé avec les paramètres de chiffrement
NotInSyncWithWorkspace

Le chiffrement est pris en charge, mais n’est pas synchronisé avec les paramètres de chiffrement
NotSupported

Le chiffrement n’est pas pris en charge pour ce jeu de données
Unknown

L’état du chiffrement est inconnu en raison de l’altération du jeu de données

PrincipalType

Énumération

Type de principal

Valeur Description
App

Type de principal de service
Group

Type de principal de groupe
None

Aucun type de principal. Utiliser pour l’ensemble de l’accès au niveau de l’organisation.
User

Type de principal de l’utilisateur

ServicePrincipalProfile

Object

Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.

Nom Type Description
displayName

string

Nom du profil du principal de service
id

string (uuid)

ID de profil du principal de service