Push Datasets - Datasets PostDatasetInGroup

Riferimento

Servizio:: Power BI REST APIs

Versione API:: v1.0

Crea un nuovo set di dati nell'area di lavoro specificata.

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/groups/{groupId}/datasets

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
groupId	path	True	string uuid	ID area di lavoro
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à del set di dati o tipo
relationships		Relationship[]	Relazioni del set di dati

Risposte

Nome	Tipo	Descrizione
201 Created	Dataset	Data di creazione
202 Accepted	Dataset	Accettato

Esempio

Push example

Esempio di richiesta

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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	Un 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à del set di dati o tipo
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 che 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 Recupera origini dati o Recupera origini dati in gruppo.
DefaultRetentionPolicy	Criteri di conservazione predefiniti
DependentDataflow	Flusso di dati dipendente da Power BI
Encryption	Informazioni di crittografia per un set di dati
EncryptionStatus	Stato della crittografia dei set di dati
Measure	Una misura di Power BI
PrincipalType	Tipo principale
Relationship	Relazione tra tabelle in un set di dati
Row	Riga di dati in un set di dati
ServicePrincipalProfile	Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.
Table	Tabella del set di dati

ASMashupExpression

Origine tabella del set di dati

Nome	Tipo	Descrizione
expression	string	Espressione di origine

Column

Colonna del set di dati

Nome	Tipo	Descrizione
dataCategory	string	facoltativo. 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	facoltativo. Formato della colonna come specificato in FORMAT_STRING.
isHidden	boolean	facoltativo. Indica se la colonna è nascosta. Il valore predefinito è `false`.
name	string	Nome della colonna
sortByColumn	string	facoltativo. Nome stringa di una colonna nella stessa tabella da usare per ordinare la colonna corrente.
summarizeBy	string	facoltativo. Funzione di aggregazione da utilizzare per il riepilogo di questa colonna.

CreateDatasetRequest

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 del 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

Direzione del filtro della relazione

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

Dataset

Un 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	Tipo di provider di contenuti per il set di dati
CreateReportEmbedURL	string	URL di incorporamento del report creato dal set di dati
CreatedDate	string	Data e ora di creazione del set di dati
Encryption	Encryption	Informazioni sulla crittografia del set di dati. Applicabile solo quando `$expand` viene specificato.
IsEffectiveIdentityRequired	boolean	Indica se il set di dati richiede un'identità effettiva, 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	Indica se il set di dati è aggiornabile o meno. Un set di dati aggiornabile di Power BI è un set di dati che è stato aggiornato almeno una volta o per cui esiste una pianificazione di aggiornamento valida.
QnaEmbedURL	string	Il set di dati Q&UN URL di incorporamento
addRowsAPIEnabled	boolean	Indica se il set di dati consente l'aggiunta di nuove righe
configuredBy	string	Proprietario del set di dati
description	string	Descrizione del set di dati
id	string	ID del set di dati
name	string	Nome del set di dati
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 (Ottieni utenti del set di dati) come API Amministrazione o l'API PostWorkspaceInfo con il `getArtifactUsers` parametro .
webUrl	string	URL Web del set di dati

DatasetMode

Modalità del set di dati o tipo

Nome	Tipo	Descrizione
AsAzure	string	Set di dati con una connessione dinamica a Azure Analysis Services
AsOnPrem	string	Set di dati con una connessione dinamica all'Azure Analysis Services locale
Push	string	Set di dati che consente l'accesso a livello di codice per il push dei dati in Power BI
PushStreaming	string	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	string	Set di dati che supporta lo streaming di dati. Per altre informazioni, vedere Streaming in tempo reale in Power BI.

DatasetQueryScaleOutSettings

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

Nome	Tipo	Descrizione
autoSyncReadOnlyReplicas	boolean	Se il set di dati sincronizza automaticamente le repliche di sola lettura
maxReadOnlyReplicas	integer	Numero massimo di repliche di sola lettura per il set di dati (0-64, -1 per il numero automatico di repliche)

DatasetUser

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

Nome	Tipo	Descrizione
datasetUserAccessRight	DatasetUserAccessRight	Diritto di accesso che l'utente ha per il set di dati (livello di autorizzazione)
displayName	string	Nome visualizzato dell'entità
emailAddress	string	Indirizzo di posta elettronica 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 principale
profile	ServicePrincipalProfile	Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.
userType	string	Tipo dell'utente.

DatasetUserAccessRight

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

Nome	Tipo	Descrizione
None	string	Rimuove l'autorizzazione per il contenuto nel set di dati
Read	string	Concede l'accesso in lettura al contenuto nel set di dati
ReadExplore	string	Concede l'accesso in lettura ed esplora al contenuto nel set di dati
ReadReshare	string	Concede l'accesso in lettura e rishare al contenuto nel set di dati
ReadReshareExplore	string	Concede lettura, ricondividi e Esplora l'accesso al contenuto nel set di dati
ReadWrite	string	Concede l'accesso in lettura e scrittura al contenuto nel set di dati
ReadWriteExplore	string	Concede l'accesso in lettura, scrittura ed esplora al contenuto nel set di dati
ReadWriteReshare	string	Concede l'accesso in lettura, scrittura e ricondividi al contenuto nel set di dati
ReadWriteReshareExplore	string	Concede lettura, scrittura, ricondividi e esplora l'accesso al contenuto nel set di dati

Datasource

Un'origine dati di Power BI

Nome	Tipo	Descrizione
connectionDetails	DatasourceConnectionDetails	Dettagli della connessione all'origine dati
connectionString	string	(Deprecato) Origine dati stringa di connessione. Disponibile solo per DirectQuery.
datasourceId	string	ID origine dati associato, vuoto quando non associato a un gateway
datasourceType	string	Tipo di origine dati
gatewayId	string	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

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

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

Criteri di conservazione predefiniti

Nome	Tipo	Descrizione
None	string	Nessuno
basicFIFO	string	basicFIFO

DependentDataflow

Flusso di dati dipendente da Power BI

Nome	Tipo	Descrizione
groupId	string	ID gruppo di destinazione
targetDataflowId	string	ID flusso di dati di destinazione

Encryption

Informazioni di crittografia per un set di dati

Nome	Tipo	Descrizione
EncryptionStatus	EncryptionStatus	Stato della crittografia dei set di dati

EncryptionStatus

Stato della crittografia dei set di dati

Nome	Tipo	Descrizione
InSyncWithWorkspace	string	La crittografia è supportata ed è sincronizzata con le impostazioni di crittografia
NotInSyncWithWorkspace	string	La crittografia è supportata ma non è sincronizzata con le impostazioni di crittografia
NotSupported	string	La crittografia non è supportata per questo set di dati
Unknown	string	Lo stato della crittografia è sconosciuto a causa del danneggiamento del set di dati

Measure

Una misura di Power BI

Nome	Tipo	Descrizione
description	string	facoltativo. Descrizione della misura.
expression	string	Espressione DAX valida
formatString	string	facoltativo. Stringa che descrive come deve essere formattato il valore quando viene visualizzato come specificato in FORMAT_STRING.
isHidden	boolean	facoltativo. Indica se la misura è nascosta.
name	string	Nome della misura

PrincipalType

Tipo principale

Nome	Tipo	Descrizione
App	string	Tipo di entità servizio
Group	string	Tipo di entità gruppo
None	string	Nessun tipo di entità. Usare per l'accesso a livello di organizzazione intero.
User	string	Tipo di entità utente

Relationship

Relazione tra tabelle in un set di dati

Nome	Tipo	Valore predefinito	Descrizione
crossFilteringBehavior	CrossFilteringBehavior	OneDirection	Direzione del filtro della relazione
fromColumn	string		Nome della colonna chiave esterna
fromTable	string		Nome della tabella di chiave esterna
name	string		Nome e identificatore della relazione
toColumn	string		Nome della colonna chiave primaria
toTable	string		Nome della tabella della chiave primaria

Row

Riga di dati in un set di dati

Nome	Tipo	Descrizione
id	string	ID di riga univoco

ServicePrincipalProfile

Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.

Nome	Tipo	Descrizione
displayName	string	Nome del profilo dell'entità servizio
id	string	ID profilo dell'entità servizio

Table

Tabella del set di dati

Nome	Tipo	Descrizione
columns	Column[]	Schema della colonna per questa tabella
description	string	Descrizione della tabella
isHidden	boolean	facoltativo. Indica se la tabella del set di dati è nascosta.
measures	Measure[]	Misure all'interno di questa tabella
name	string	Il nome della tabella
rows	Row[]	Righe di dati all'interno di questa tabella
source	ASMashupExpression[]	Origine tabella

Condividi tramite