Push Datasets - Datasets PostDataset

Reference

Service:: Power BI REST APIs

API Version:: v1.0

Vytvoří novou datovou sadu v pracovním prostoru.

Požadovaný obor

Dataset.ReadWrite.All

Omezení

Toto volání rozhraní API podporuje pouze datové sady nabízených oznámení. Úplný seznam omezení najdete v tématu Omezení nabízených datových sad.

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

With optional parameters:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
defaultRetentionPolicy	query		DefaultRetentionPolicy	Výchozí zásady uchovávání informací

Text požadavku

Name	Vyžadováno	Typ	Description
name	True	string	Název datové sady
tables	True	Table[]	Tabulky datových sad
datasources		Datasource[]	Zdroje dat přidružené k této datové sadě
defaultMode		DatasetMode	Režim nebo typ datové sady
relationships		Relationship[]	Relace datové sady

Odpovědi

Name	Typ	Description
201 Created	Dataset	Vytvořeno
202 Accepted	Dataset	Přijato

Příklady

Push example

Sample Request

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

Request Body

{
  "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"
        }
      ]
    }
  ]
}

Sample Response

Status code:: 201

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

Definice

Name	Description
ASMashupExpression	Zdroj tabulky datové sady
Column	Sloupec datové sady
CreateDatasetRequest	Datová sada Power BI
CrossFilteringBehavior	Směr filtru relace
Dataset	Datová sada Power BI. Rozhraní API vrátí podmnožinu z následujícího seznamu vlastností datové sady. Podmnožina závisí na volaným rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.
DatasetMode	Režim nebo typ datové sady
DatasetQueryScaleOutSettings	Dotaz na nastavení škálování datové sady na více instancí
DatasetUser	Položka přístupového práva uživatele Power BI pro datovou sadu
DatasetUserAccessRight	Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění)
Datasource	Zdroj dat Power BI
DatasourceConnectionDetails	Podrobnosti o připojení ke zdroji dat Power BI Příklady najdete v tématech Získání zdrojů dat nebo Získání zdrojů dat do skupiny.
DefaultRetentionPolicy	Výchozí zásady uchovávání informací
DependentDataflow	Tok dat závislý na Power BI
Encryption	Informace o šifrování datové sady
EncryptionStatus	Stav šifrování datové sady
Measure	Míra Power BI
PrincipalType	Typ objektu zabezpečení
Relationship	Relace mezi tabulkami v datové sadě
Row	Řádek dat v datové sadě
ServicePrincipalProfile	Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.
Table	Tabulka datové sady

ASMashupExpression

Zdroj tabulky datové sady

Name	Typ	Description
expression	string	Zdrojový výraz

Column

Sloupec datové sady

Name	Typ	Description
dataCategory	string	Nepovinný parametr. Hodnota řetězce, která se má použít pro kategorii dat, která popisuje data v tomto sloupci.
dataType	string	Datový typ sloupce
formatString	string	Nepovinný parametr. Formát sloupce zadaný v FORMAT_STRING.
isHidden	boolean	Nepovinný parametr. Určuje, jestli je sloupec skrytý. Výchozí formát je `false`.
name	string	Název sloupce
sortByColumn	string	Nepovinný parametr. Název řetězce pro sloupec ve stejné tabulce, podle kterého se seřadí aktuální sloupec.
summarizeBy	string	Nepovinný parametr. Agregační funkce, která se má použít pro shrnutí tohoto sloupce.

CreateDatasetRequest

Datová sada Power BI

Name	Typ	Description
datasources	Datasource[]	Zdroje dat přidružené k této datové sadě
defaultMode	DatasetMode	Režim nebo typ datové sady
name	string	Název datové sady
relationships	Relationship[]	Relace datové sady
tables	Table[]	Tabulky datových sad

CrossFilteringBehavior

Směr filtru relace

Name	Typ	Description
Automatic	string	Chování křížového filtrování se definuje automaticky.
BothDirections	string	Pro účely filtrování se obě tabulky považují za jednu tabulku.
OneDirection	string	Pro účely filtrování se filtr použije na tabulku, ve které se agregují hodnoty.

Dataset

Datová sada Power BI. Rozhraní API vrátí podmnožinu z následujícího seznamu vlastností datové sady. Podmnožina závisí na volaným rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.

Name	Typ	Description
ContentProviderType	string	Typ zprostředkovatele obsahu pro datovou sadu
CreateReportEmbedURL	string	Adresa URL pro vložení sestavy pro vytvoření datové sady
CreatedDate	string	Datum a čas vytvoření datové sady
Encryption	Encryption	Informace o šifrování datové sady. Platí pouze v případě, že `$expand` je zadáno.
IsEffectiveIdentityRequired	boolean	Jestli datová sada vyžaduje efektivní identitu, kterou musíte odeslat ve volání rozhraní API GenerateToken .
IsEffectiveIdentityRolesRequired	boolean	Určuje, jestli je v souboru .pbix Power BI definované zabezpečení na úrovni řádků. Pokud ano, musíte zadat roli.
IsInPlaceSharingEnabled	boolean	Jestli je možné datovou sadu sdílet s externími uživateli, aby ji mohli využívat ve svém vlastním tenantovi.
IsOnPremGatewayRequired	boolean	Jestli datová sada vyžaduje místní bránu dat
IsRefreshable	boolean	Jestli je datová sada aktualizovatelná nebo ne. Aktualizovatelná datová sada Power BI je datová sada, která se alespoň jednou aktualizovala nebo pro kterou existuje platný plán aktualizace.
QnaEmbedURL	string	Adresa URL pro vložení Q&A datové sady
addRowsAPIEnabled	boolean	Jestli datová sada umožňuje přidávat nové řádky
configuredBy	string	Vlastník datové sady
description	string	Popis datové sady
id	string	ID datové sady
name	string	Název datové sady
queryScaleOutSettings	DatasetQueryScaleOutSettings	Dotaz na nastavení škálování datové sady na více instancí
targetStorageMode	string	Režim úložiště datové sady
upstreamDataflows	DependentDataflow[]	Seznam všech toků dat, na které tato položka závisí
users	DatasetUser[]	(Prázdná hodnota) Podrobnosti o přístupu uživatele k datové sadě Tato vlastnost bude odebrána z odpovědi datové části v nadcházející verzi. Informace o uživatelích u položky Power BI (například sestavy nebo řídicího panelu) můžete načíst pomocí rozhraní API Get Dataset Users as Správa nebo rozhraní API PostWorkspaceInfo s parametrem `getArtifactUsers` .
webUrl	string	Webová adresa URL datové sady

DatasetMode

Režim nebo typ datové sady

Name	Typ	Description
AsAzure	string	Datová sada s živým připojením k Azure Analysis Services
AsOnPrem	string	Datová sada s živým připojením k místnímu Azure Analysis Services
Push	string	Datová sada, která umožňuje programový přístup pro vkládání dat do Power BI
PushStreaming	string	Datová sada, která podporuje streamování dat a umožňuje programový přístup pro vkládání dat do Power BI
Streaming	string	Datová sada, která podporuje streamování dat. Další informace najdete v článku o streamování v reálném čase v Power BI.

DatasetQueryScaleOutSettings

Dotaz na nastavení škálování datové sady na více instancí

Name	Typ	Description
autoSyncReadOnlyReplicas	boolean	Jestli datová sada automaticky synchronizuje repliky jen pro čtení
maxReadOnlyReplicas	integer	Maximální počet replik jen pro čtení pro datovou sadu (0–64, -1 pro automatický počet replik)

DatasetUser

Položka přístupového práva uživatele Power BI pro datovou sadu

Name	Typ	Description
datasetUserAccessRight	DatasetUserAccessRight	Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění)
displayName	string	Zobrazovaný název objektu zabezpečení
emailAddress	string	E-mailová adresa uživatele
graphId	string	Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.
identifier	string	Identifikátor objektu zabezpečení
principalType	PrincipalType	Typ objektu zabezpečení
profile	ServicePrincipalProfile	Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.
userType	string	Typ uživatele.

DatasetUserAccessRight

Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění)

Name	Typ	Description
None	string	Odebere oprávnění k obsahu v datové sadě.
Read	string	Udělí oprávnění ke čtení obsahu v datové sadě.
ReadExplore	string	Udělí přístup ke čtení a prozkoumání obsahu v datové sadě.
ReadReshare	string	Uděluje přístup ke čtení a sdílení obsahu v datové sadě.
ReadReshareExplore	string	Uděluje přístup ke čtení, sdílení a prozkoumání obsahu v datové sadě.
ReadWrite	string	Uděluje přístup ke čtení a zápisu k obsahu v datové sadě.
ReadWriteExplore	string	Uděluje přístup ke čtení, zápisu a prozkoumání obsahu v datové sadě.
ReadWriteReshare	string	Uděluje přístup ke čtení, zápisu a sdílení obsahu v datové sadě.
ReadWriteReshareExplore	string	Uděluje přístup ke čtení, zápisu, sdílení a prozkoumání obsahu v datové sadě.

Datasource

Zdroj dat Power BI

Name	Typ	Description
connectionDetails	DatasourceConnectionDetails	Podrobnosti o připojení ke zdroji dat
connectionString	string	(Zastaralé) Zdroj dat připojovací řetězec. K dispozici pouze pro DirectQuery.
datasourceId	string	ID vázaného zdroje dat, které je prázdné, pokud není vázané na bránu
datasourceType	string	Typ zdroje dat
gatewayId	string	ID vázané brány, které je prázdné, pokud není vázané na bránu. Při použití clusteru brány odkazuje ID brány na primární (první) bránu v clusteru a podobá se ID clusteru brány.
name	string	(Zastaralé) Název zdroje dat. K dispozici pouze pro DirectQuery.

DatasourceConnectionDetails

Podrobnosti o připojení ke zdroji dat Power BI Příklady najdete v tématech Získání zdrojů dat nebo Získání zdrojů dat do skupiny.

Name	Typ	Description
account	string	Účet připojení
classInfo	string	Informace o třídě připojení
database	string	Databáze připojení
domain	string	Doména připojení
emailAddress	string	E-mailová adresa připojení
kind	string	Druh připojení
loginServer	string	Přihlašovací server připojení
path	string	Cesta k připojení
server	string	Server připojení
url	string	Adresa URL připojení

DefaultRetentionPolicy

Výchozí zásady uchovávání informací

Name	Typ	Description
None	string	Žádné
basicFIFO	string	basicFIFO

DependentDataflow

Tok dat závislý na Power BI

Name	Typ	Description
groupId	string	ID cílové skupiny
targetDataflowId	string	ID cílového toku dat

Encryption

Informace o šifrování datové sady

Name	Typ	Description
EncryptionStatus	EncryptionStatus	Stav šifrování datové sady

EncryptionStatus

Stav šifrování datové sady

Name	Typ	Description
InSyncWithWorkspace	string	Šifrování se podporuje a synchronizuje se s nastavením šifrování.
NotInSyncWithWorkspace	string	Šifrování se podporuje, ale není synchronizované s nastavením šifrování.
NotSupported	string	U této datové sady se nepodporuje šifrování.
Unknown	string	Stav šifrování je neznámý kvůli poškození datové sady.

Measure

Míra Power BI

Name	Typ	Description
description	string	Nepovinný parametr. Popis míry.
expression	string	Platný výraz DAX
formatString	string	Nepovinný parametr. Řetězec popisující, jak má být hodnota formátována, když je zobrazena tak, jak je uvedeno v FORMAT_STRING.
isHidden	boolean	Nepovinný parametr. Jestli je míra skrytá.
name	string	Název míry

PrincipalType

Typ objektu zabezpečení

Name	Typ	Description
App	string	Typ instančního objektu
Group	string	Typ objektu zabezpečení skupiny
None	string	Žádný typ objektu zabezpečení. Používá se pro přístup na úrovni celé organizace.
User	string	Typ objektu zabezpečení uživatele

Relationship

Relace mezi tabulkami v datové sadě

Name	Typ	Výchozí hodnota	Description
crossFilteringBehavior	CrossFilteringBehavior	OneDirection	Směr filtru relace
fromColumn	string		Název sloupce cizího klíče
fromTable	string		Název tabulky cizích klíčů
name	string		Název a identifikátor relace
toColumn	string		Název sloupce primárního klíče
toTable	string		Název tabulky primárních klíčů

Row

Řádek dat v datové sadě

Name	Typ	Description
id	string	Jedinečné ID řádku

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

Name	Typ	Description
displayName	string	Název profilu instančního objektu
id	string	ID profilu instančního objektu

Table

Tabulka datové sady

Name	Typ	Description
columns	Column[]	Schéma sloupců pro tuto tabulku
description	string	Popis tabulky
isHidden	boolean	Nepovinný parametr. Určuje, jestli je tato tabulka datové sady skrytá.
measures	Measure[]	Míry v této tabulce
name	string	Název tabulky
rows	Row[]	Řádky dat v této tabulce
source	ASMashupExpression[]	Zdroj tabulky