Push Datasets - Datasets PostDataset

Riferimento

Servizio:: Power BI REST APIs

Versione API:: v1.0

Crea un nuovo set di dati in Area di lavoro personale.

Ambito obbligatorio

Dataset.ReadWrite.All

Limitazioni

Questa chiamata API supporta solo set di dati push . Per un elenco completo delle limitazioni, vedere Limitazioni dei set di dati push.

POST https://api.powerbi.com/v1.0/myorg/datasets

Con parametri facoltativi:

POST https://api.powerbi.com/v1.0/myorg/datasets?defaultRetentionPolicy={defaultRetentionPolicy}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
defaultRetentionPolicy	query		DefaultRetentionPolicy	Criteri di conservazione predefiniti

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
name	True	string	Nome del set di dati
tables	True	Table[]	Tabelle del set di dati
datasources		Datasource[]	Origini dati associate a questo set di dati
defaultMode		DatasetMode	Modalità o tipo di set di dati
relationships		Relationship[]	Relazioni tra set di dati

Risposte

Nome	Tipo	Descrizione
201 Created	Dataset	Creato
202 Accepted	Dataset	Accettato

Esempio

Push example

Esempio di richiesta

POST https://api.powerbi.com/v1.0/myorg/datasets?defaultRetentionPolicy=basicFIFO

Corpo della richiesta

{
  "name": "SalesMarketing",
  "defaultMode": "Push",
  "tables": [
    {
      "name": "Product",
      "columns": [
        {
          "name": "ProductID",
          "dataType": "Int64"
        },
        {
          "name": "Name",
          "dataType": "string"
        },
        {
          "name": "Category",
          "dataType": "string"
        },
        {
          "name": "IsCompete",
          "dataType": "bool"
        },
        {
          "name": "ManufacturedOn",
          "dataType": "DateTime"
        },
        {
          "name": "Sales",
          "dataType": "Int64",
          "formatString": "Currency"
        }
      ]
    }
  ]
}

Risposta di esempio

Codice di stato:: 201

{
  "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "name": "SalesMarketing",
  "defaultRetentionPolicy": "basicFIFO"
}

Definizioni

Nome	Descrizione
ASMashupExpression	Origine tabella del set di dati
Column	Colonna del set di dati
CreateDatasetRequest	Un set di dati di Power BI
CrossFilteringBehavior	Direzione del filtro della relazione
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.
DatasetMode	Modalità o tipo di set di dati
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)
Datasource	Un'origine dati di Power BI
DatasourceConnectionDetails	Dettagli della connessione all'origine dati di Power BI. Vedere esempi in Ottenere origini dati o Recupera origini dati in.
DefaultRetentionPolicy	Criteri di conservazione predefiniti
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
Measure	Una misura di Power BI
PrincipalType	Tipo di entità
Relationship	Relazione tra tabelle in un set di dati
Row	Riga di dati in un set di dati
ServicePrincipalProfile	Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.
Table	Tabella del set di dati

ASMashupExpression

Object

Origine tabella del set di dati

Nome	Tipo	Descrizione
expression	string	Espressione di origine

Column

Object

Colonna del set di dati

Nome	Tipo	Descrizione
dataCategory	string	Opzionale. Valore stringa da utilizzare per la categoria di dati che descrive i dati all'interno di questa colonna.
dataType	string	Tipo di dati della colonna
formatString	string	Opzionale. Formato della colonna come specificato in FORMAT_STRING.
isHidden	boolean	Opzionale. Indica se la colonna è nascosta. Il valore predefinito è `false`.
name	string pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$	Nome della colonna
sortByColumn	string	Opzionale. Nome stringa di una colonna nella stessa tabella da utilizzare per ordinare la colonna corrente.
summarizeBy	string	Opzionale. Funzione di aggregazione da utilizzare per riepilogare questa colonna.

CreateDatasetRequest

Object

Un set di dati di Power BI

Nome	Tipo	Descrizione
datasources	Datasource[]	Origini dati associate a questo set di dati
defaultMode	DatasetMode	Modalità o tipo di set di dati
name	string	Nome del set di dati
relationships	Relationship[]	Relazioni tra set di dati
tables	Table[]	Tabelle del set di dati

CrossFilteringBehavior

Enumerazione

Direzione del filtro della relazione

Valore	Descrizione
Automatic	Il comportamento di filtro incrociato viene definito automaticamente
BothDirections	A scopo di filtro, entrambe le tabelle vengono considerate come una singola tabella.
OneDirection	Ai fini del filtro, il filtro verrà applicato alla tabella in cui vengono aggregati i valori.

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

DatasetMode

Enumerazione

Modalità o tipo di set di dati

Valore	Descrizione
AsAzure	Un set di dati con una connessione dinamica ad Azure Analysis Services
AsOnPrem	Un set di dati con una connessione dinamica ad Azure Analysis Services locale
Push	Set di dati che consente l'accesso a livello di codice per il push dei dati in Power BI
PushStreaming	Set di dati che supporta lo streaming dei dati e consente l'accesso a livello di codice per il push dei dati in Power BI
Streaming	Set di dati che supporta lo streaming di dati. Per altre informazioni, vedere Streaming in tempo reale in Power BI.

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

Datasource

Object

Un'origine dati di Power BI

Nome	Tipo	Descrizione
connectionDetails	DatasourceConnectionDetails	Dettagli della connessione all'origine dati
connectionString	string	(Deprecato) Stringa di connessione dell'origine dati. Disponibile solo per DirectQuery.
datasourceId	string (uuid)	ID origine dati associata, vuoto quando non associato a un gateway
datasourceType	string	Tipo di origine dati
gatewayId	string (uuid)	ID del gateway associato, vuoto quando non associato a un gateway. Quando si usa un cluster gateway, l'ID gateway fa riferimento al gateway primario (primo) nel cluster ed è simile all'ID cluster del gateway.
name	string	(Deprecato) Nome dell'origine dati. Disponibile solo per DirectQuery.

DatasourceConnectionDetails

Object

Dettagli della connessione all'origine dati di Power BI. Vedere esempi in Ottenere origini dati o Recupera origini dati in.

Nome	Tipo	Descrizione
account	string	Account di connessione
classInfo	string	Informazioni sulla classe di connessione
database	string	Database di connessione
domain	string	Dominio di connessione
emailAddress	string	Indirizzo di posta elettronica di connessione
kind	string	Tipo di connessione
loginServer	string	Server di accesso alla connessione
path	string	Percorso di connessione
server	string	Server di connessione
url	string	URL di connessione

DefaultRetentionPolicy

Enumerazione

Criteri di conservazione predefiniti

Valore	Descrizione
None	Nessuno
basicFIFO	basicFIFO

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

Measure

Object

Una misura di Power BI

Nome	Tipo	Descrizione
description	string	Opzionale. Descrizione della misura.
expression	string	Espressione DAX valida
formatString	string	Opzionale. Stringa che descrive come formattare il valore quando viene visualizzato come specificato in FORMAT_STRING.
isHidden	boolean	Opzionale. Indica se la misura è nascosta.
name	string pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$	Nome della misura

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

Relationship

Object

Relazione tra tabelle in un set di dati

Nome	Tipo	Valore predefinito	Descrizione
crossFilteringBehavior	CrossFilteringBehavior	OneDirection	Direzione del filtro della relazione
fromColumn	string pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$		Nome della colonna chiave esterna
fromTable	string pattern: ^[\x09\x0A\x0D\x20\x23\x2D\x30-\x39\x40-\x5A\x5E-\x5F\x61-\x7A\x7E-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]{1,100}$		Nome della tabella di chiave esterna
name	string pattern: ^[\x09\x0A\x0D\x20\x23\x2D\x30-\x39\x40-\x5A\x5E-\x5F\x61-\x7A\x7E-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]{1,100}$		Nome e identificatore della relazione
toColumn	string pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$		Nome della colonna chiave primaria
toTable	string pattern: ^[\x09\x0A\x0D\x20\x23\x2D\x30-\x39\x40-\x5A\x5E-\x5F\x61-\x7A\x7E-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]{1,100}$		Nome della tabella della chiave primaria

Row

Object

Riga di dati in un set di dati

Nome	Tipo	Descrizione
id	string	ID riga univoco

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

Table

Object

Tabella del set di dati

Nome	Tipo	Descrizione
columns	Column[]	Schema di colonna per questa tabella
description	string	Descrizione della tabella
isHidden	boolean	Opzionale. Indica se la tabella del set di dati è nascosta.
measures	Measure[]	Misure all'interno di questa tabella
name	string pattern: ^[\x09\x0A\x0D\x20\x23\x2D\x30-\x39\x40-\x5A\x5E-\x5F\x61-\x7A\x7E-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]{1,100}$	Nome della tabella
rows	Row[]	Righe di dati all'interno di questa tabella
source	ASMashupExpression[]	Origine tabella

Condividi tramite

Push Datasets - Datasets PostDataset

Ambito obbligatorio

Limitazioni

Parametri dell'URI

Corpo della richiesta

Risposte

Esempio

Push example

Esempio di richiesta

Risposta di esempio

Definizioni

ASMashupExpression

Column

CreateDatasetRequest

CrossFilteringBehavior

Dataset

DatasetMode

DatasetQueryScaleOutSettings

DatasetUser

DatasetUserAccessRight

Datasource

DatasourceConnectionDetails

DefaultRetentionPolicy

DependentDataflow

Encryption

EncryptionStatus

Measure

PrincipalType

Relationship

Row

ServicePrincipalProfile

Table

Risorse aggiuntive