Condividi tramite

Datasets - Get Dataset

  • Riferimento
Servizio:
Power BI REST APIs
Versione API:
v1.0

Restituisce il set di dati specificato da Area di lavoro personale.

Ambito obbligatorio

Dataset.ReadWrite.All o Dataset.Read.All 

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
datasetId
 path True

string

ID set di dati

Risposte

Nome Tipo Descrizione
200 OK

Dataset

Va bene

Esempio

Example

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
200 
{
  "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "name": "SalesMarketing",
  "addRowsAPIEnabled": false,
  "configuredBy": "john@contoso.com",
  "isRefreshable": true,
  "isEffectiveIdentityRequired": true,
  "isEffectiveIdentityRolesRequired": true,
  "isOnPremGatewayRequired": false
}

Definizioni

Nome Descrizione
Dataset

Set di dati di Power BI. L'API restituisce un subset dell'elenco seguente di proprietà del set di dati. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.
DatasetQueryScaleOutSettings

Eseguire query su impostazioni di scalabilità orizzontale di un set di dati
DatasetUser

Voce a destra dell'accesso utente di Power BI per un set di dati
DatasetUserAccessRight

Diritto di accesso a cui l'utente ha per il set di dati (livello di autorizzazione)
DependentDataflow

Flusso di dati dipendente da Power BI
Encryption

Informazioni di crittografia per un set di dati
EncryptionStatus

Stato di crittografia del set di dati
PrincipalType

Tipo di entità
ServicePrincipalProfile

Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.

Dataset

Object

Set di dati di Power BI. L'API restituisce un subset dell'elenco seguente di proprietà del set di dati. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.

Nome Tipo Descrizione
ContentProviderType

string

Proprietà deprecata che deve essere ignorata.
Encryption

Encryption

Informazioni sulla crittografia del set di dati. Applicabile solo quando si specifica $expand.
IsEffectiveIdentityRequired

boolean

Indica se il set di dati richiede un'identità efficace, che è necessario inviare in una chiamata API GenerateToken.
IsEffectiveIdentityRolesRequired

boolean

Indica se la sicurezza a livello di riga è definita all'interno del file con estensione pbix di Power BI. In tal caso, è necessario specificare un ruolo.
IsInPlaceSharingEnabled

boolean

Indica se il set di dati può essere condiviso con utenti esterni da utilizzare nel proprio tenant
IsOnPremGatewayRequired

boolean

Indica se il set di dati richiede un gateway dati locale
IsRefreshable

boolean

Questo campo restituisce true quando il set di dati viene aggiornato di recente o configurato per l'aggiornamento automatico, con la modalità di connessione impostata specificamente su "Importa". Il valore restituirà false per altre modalità di connessione, ad esempio "DirectQuery" e "LiveConnection", indipendentemente dal fatto che il set di dati sia aggiornato manualmente o sia configurato per l'aggiornamento automatico.
addRowsAPIEnabled

boolean

Indica se il set di dati consente l'aggiunta di nuove righe
configuredBy

string

Proprietario del set di dati
createReportEmbedURL

string

Il set di dati crea l'URL di incorporamento del report
createdDate

string (date-time)

Data e ora di creazione del set di dati
description

string

Descrizione del set di dati
id

string

ID set di dati
name

string

Nome del set di dati
qnaEmbedURL

string

Il set di dati Q&UN URL di incorporamento
queryScaleOutSettings

DatasetQueryScaleOutSettings

Eseguire query su impostazioni di scalabilità orizzontale di un set di dati
targetStorageMode

string

Modalità di archiviazione del set di dati
upstreamDataflows

DependentDataflow[]

L'elenco di tutti i flussi di dati da cui dipende questo elemento
users

DatasetUser[]

(Valore vuoto) Dettagli di accesso utente del set di dati. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare informazioni utente su un elemento di Power BI, ad esempio un report o un dashboard, usando l'API Get Dataset Users as Admin o l'API PostWorkspaceInfo con il parametro getArtifactUsers.
webUrl

string

URL Web del set di dati

DatasetQueryScaleOutSettings

Object

Eseguire query su impostazioni di scalabilità orizzontale di un set di dati

Nome Tipo Descrizione
autoSyncReadOnlyReplicas

boolean

Indica se il set di dati sincronizza automaticamente le repliche di sola lettura
maxReadOnlyReplicas

integer

minimum: -1
maximum: 64

Numero massimo di repliche di sola lettura per il set di dati (0-64, -1 per il numero automatico di repliche)

DatasetUser

Object

Voce a destra dell'accesso utente di Power BI per un set di dati

Nome Tipo Descrizione
datasetUserAccessRight

DatasetUserAccessRight

Diritto di accesso a cui l'utente ha per il set di dati (livello di autorizzazione)
displayName

string

Nome visualizzato dell'entità
emailAddress

string

Indirizzo e-mail dell'utente
graphId

string

Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione.
identifier

string

Identificatore dell'entità
principalType

PrincipalType

Tipo di entità
profile

ServicePrincipalProfile

Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.
userType

string

Tipo di utente.

DatasetUserAccessRight

Enumerazione

Diritto di accesso a cui l'utente ha per il set di dati (livello di autorizzazione)

Valore Descrizione
None

Rimuove l'autorizzazione per il contenuto nel set di dati
Read

Concede l'accesso in lettura al contenuto nel set di dati
ReadExplore

Concede l'accesso in lettura ed esplora al contenuto nel set di dati
ReadReshare

Concede l'accesso in lettura e ricondivisione al contenuto nel set di dati
ReadReshareExplore

Concede l'accesso in lettura, ricondivisione ed esplora al contenuto nel set di dati
ReadWrite

Concede l'accesso in lettura e scrittura al contenuto nel set di dati
ReadWriteExplore

Concede l'accesso in lettura, scrittura ed esplorazione al contenuto nel set di dati
ReadWriteReshare

Concede l'accesso in lettura, scrittura e ricondivisione al contenuto nel set di dati
ReadWriteReshareExplore

Concede l'accesso al contenuto nel set di dati di lettura, scrittura, ricondivisione ed esplora

DependentDataflow

Object

Flusso di dati dipendente da Power BI

Nome Tipo Descrizione
groupId

string

ID del gruppo di destinazione
targetDataflowId

string

ID flusso di dati di destinazione

Encryption

Object

Informazioni di crittografia per un set di dati

Nome Tipo Descrizione
EncryptionStatus

EncryptionStatus

Stato di crittografia del set di dati

EncryptionStatus

Enumerazione

Stato di crittografia del set di dati

Valore Descrizione
InSyncWithWorkspace

La crittografia è supportata ed è sincronizzata con le impostazioni di crittografia
NotInSyncWithWorkspace

La crittografia è supportata ma non è sincronizzata con le impostazioni di crittografia
NotSupported

La crittografia non è supportata per questo set di dati
Unknown

Lo stato della crittografia è sconosciuto a causa del danneggiamento del set di dati

PrincipalType

Enumerazione

Tipo di entità

Valore Descrizione
App

Tipo di entità servizio
Group

Tipo di entità gruppo
None

Nessun tipo di entità. Usare per l'accesso a livello di organizzazione intero.
User

Tipo di entità utente

ServicePrincipalProfile

Object

Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.

Nome Tipo Descrizione
displayName

string

Nome del profilo dell'entità servizio
id

string (uuid)

ID del profilo dell'entità servizio