Push Datasets - Datasets PostDataset

Service:

Power BI REST APIs

API Version:

v1.0

Çalışma alanım'da yeni bir veri kümesi oluşturur.

Gerekli Kapsam

Dataset.ReadWrite.All

Sınırlamalar

Bu API çağrısı yalnızca gönderme veri kümelerini destekler. Sınırlamaların tam listesi için bkz . Gönderme veri kümeleri sınırlamaları.

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

With optional parameters:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
defaultRetentionPolicy	query		DefaultRetentionPolicy	Varsayılan saklama ilkesi

İstek Gövdesi

Name	Gerekli	Tür	Description
name	True	string	Veri kümesi adı
tables	True	Table[]	Veri kümesi tabloları
datasources		Datasource[]	Bu veri kümesiyle ilişkili veri kaynakları
defaultMode		DatasetMode	Veri kümesi modu veya türü
relationships		Relationship[]	Veri kümesi ilişkileri

Yanıtlar

Name	Tür	Description
201 Created	Dataset	Oluşturulan
202 Accepted	Dataset	Kabul edildi

Örnekler

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

Tanımlar

Name	Description
ASMashupExpression	Veri kümesi tablosu kaynağı
Column	Veri kümesi sütunu
CreateDatasetRequest	Power BI veri kümesi
CrossFilteringBehavior	İlişkinin filtre yönü
Dataset	Power BI veri kümesi. API, aşağıdaki veri kümesi özellikleri listesinin bir alt kümesini döndürür. Alt küme, çağrılan API'ye, çağıran izinlerine ve Power BI veritabanındaki verilerin kullanılabilirliğine bağlıdır.
DatasetMode	Veri kümesi modu veya türü
DatasetQueryScaleOutSettings	Veri kümesinin ölçeği genişletme ayarlarını sorgulama
DatasetUser	Bir veri kümesi için Power BI kullanıcı erişim hakkı girişi
DatasetUserAccessRight	Kullanıcının veri kümesi için sahip olduğu erişim hakkı (izin düzeyi)
Datasource	Power BI veri kaynağı
DatasourceConnectionDetails	Power BI veri kaynağı bağlantı ayrıntıları. Veri Kaynaklarını Alma veya Grup halinde Veri Kaynakları Alma ile ilgili örneklere bakın.
DefaultRetentionPolicy	Varsayılan saklama ilkesi
DependentDataflow	Power BI'a bağımlı veri akışı
Encryption	Veri kümesi için şifreleme bilgileri
EncryptionStatus	Veri kümesi şifreleme durumu
Measure	Power BI ölçüsü
PrincipalType	Sorumlu türü
Relationship	Veri kümesindeki tablolar arasındaki ilişki
Row	Veri kümesindeki veri satırı
ServicePrincipalProfile	Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.
Table	Veri kümesi tablosu

ASMashupExpression

Veri kümesi tablosu kaynağı

Name	Tür	Description
expression	string	Kaynak ifade

Column

Veri kümesi sütunu

Name	Tür	Description
dataCategory	string	İsteğe bağlı. Bu sütundaki verileri açıklayan veri kategorisi için kullanılacak dize değeri.
dataType	string	Sütun veri türü
formatString	string	İsteğe bağlı. FORMAT_STRING'de belirtilen sütunun biçimi.
isHidden	boolean	İsteğe bağlı. Sütunun gizli olup olmadığı. Varsayılan değer: false.
name	string	Sütun adı
sortByColumn	string	İsteğe bağlı. Geçerli sütunu sıralamak için kullanılacak, aynı tablodaki bir sütunun dize adı.
summarizeBy	string	İsteğe bağlı. Bu sütunu özetlemek için kullanılacak toplama işlevi.

CreateDatasetRequest

Power BI veri kümesi

Name	Tür	Description
datasources	Datasource[]	Bu veri kümesiyle ilişkili veri kaynakları
defaultMode	DatasetMode	Veri kümesi modu veya türü
name	string	Veri kümesi adı
relationships	Relationship[]	Veri kümesi ilişkileri
tables	Table[]	Veri kümesi tabloları

CrossFilteringBehavior

İlişkinin filtre yönü

Name	Tür	Description
Automatic	string	Çapraz filtreleme davranışı otomatik olarak tanımlanır
BothDirections	string	Filtreleme amacıyla her iki tablo da tek bir tablo olarak değerlendirilir.
OneDirection	string	Filtreleme amacıyla, filtre değerlerin toplandığı tabloya uygulanır.

Dataset

Power BI veri kümesi. API, aşağıdaki veri kümesi özellikleri listesinin bir alt kümesini döndürür. Alt küme, çağrılan API'ye, çağıran izinlerine ve Power BI veritabanındaki verilerin kullanılabilirliğine bağlıdır.

Name	Tür	Description
ContentProviderType	string	Veri kümesinin içerik sağlayıcısı türü
CreateReportEmbedURL	string	Veri kümesi rapor ekleme URL'si oluşturur
CreatedDate	string	Veri kümesi oluşturma tarihi ve saati
Encryption	Encryption	Veri kümesi şifreleme bilgileri. Yalnızca belirtildiğinde $expand geçerlidir.
IsEffectiveIdentityRequired	boolean	Veri kümesinin etkili bir kimlik gerektirilip gerekmediği; bir GenerateToken API çağrısında göndermeniz gerekir.
IsEffectiveIdentityRolesRequired	boolean	Satır düzeyi güvenliğin Power BI .pbix dosyasında tanımlanıp tanımlanmadığı. Öyleyse, bir rol belirtmeniz gerekir.
IsInPlaceSharingEnabled	boolean	Veri kümesinin kendi kiracılarında kullanılacak dış kullanıcılarla paylaşılıp paylaşılamayacağı
IsOnPremGatewayRequired	boolean	Veri kümesinin şirket içi veri ağ geçidi gerektip gerektirmediği
IsRefreshable	boolean	Veri kümesinin yenilenebilir olup olmadığı. Power BI yenilenebilir veri kümesi, en az bir kez yenilenen veya geçerli bir yenileme zamanlaması bulunan bir veri kümesidir.
QnaEmbedURL	string	Q&A ekleme URL'si veri kümesi
addRowsAPIEnabled	boolean	Veri kümesinin yeni satır eklemeye izin verip vermediği
configuredBy	string	Veri kümesi sahibi
description	string	Veri kümesi açıklaması
id	string	Veri kümesi kimliği
name	string	Veri kümesi adı
queryScaleOutSettings	DatasetQueryScaleOutSettings	Veri kümesinin ölçeği genişletme ayarlarını sorgulama
targetStorageMode	string	Veri kümesi depolama modu
upstreamDataflows	DependentDataflow[]	Bu öğenin bağlı olduğu tüm veri akışlarının listesi
users	DatasetUser[]	(Boş değer) Veri kümesi kullanıcı erişim ayrıntıları. Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Veri Kümesi Kullanıcılarını Yönetici API olarak alma veya PostWorkspaceInfo API'sini parametresiyle getArtifactUsers kullanarak bir Power BI öğesindeki kullanıcı bilgilerini (rapor veya pano gibi) alabilirsiniz.
webUrl	string	Veri kümesinin web URL'si

DatasetMode

Veri kümesi modu veya türü

Name	Tür	Description
AsAzure	string	Azure Analysis Services canlı bağlantısı olan veri kümesi
AsOnPrem	string	Şirket içi Azure Analysis Services canlı bağlantısı olan veri kümesi
Push	string	Power BI'a veri göndermek için programlı erişim sağlayan veri kümesi
PushStreaming	string	Veri akışını destekleyen ve Power BI'a veri göndermek için programlı erişim sağlayan bir veri kümesi
Streaming	string	Veri akışını destekleyen bir veri kümesi. Daha fazla bilgi için bkz. Power BI’da gerçek zamanlı akış yapma.

DatasetQueryScaleOutSettings

Veri kümesinin ölçeği genişletme ayarlarını sorgulama

Name	Tür	Description
autoSyncReadOnlyReplicas	boolean	Veri kümesinin salt okunur çoğaltmaları otomatik olarak eşitleyip eşitlemediği
maxReadOnlyReplicas	integer	Veri kümesi için en fazla salt okunur çoğaltma sayısı (otomatik çoğaltma sayısı için 0-64, -1)

DatasetUser

Bir veri kümesi için Power BI kullanıcı erişim hakkı girişi

Name	Tür	Description
datasetUserAccessRight	DatasetUserAccessRight	Kullanıcının veri kümesi için sahip olduğu erişim hakkı (izin düzeyi)
displayName	string	Sorumlunun görünen adı
emailAddress	string	Kullanıcının e-posta adresi
graphId	string	Microsoft Graph'ta sorumlunun tanımlayıcısı. Yalnızca yönetici API'leri için kullanılabilir.
identifier	string	Sorumlunun tanımlayıcısı
principalType	PrincipalType	Sorumlu türü
profile	ServicePrincipalProfile	Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.
userType	string	Kullanıcının türü.

DatasetUserAccessRight

Kullanıcının veri kümesi için sahip olduğu erişim hakkı (izin düzeyi)

Name	Tür	Description
None	string	Veri kümesindeki içeriğe yönelik izni kaldırır
Read	string	Veri kümesindeki içeriğe Okuma erişimi verir
ReadExplore	string	Veri kümesindeki içeriğe Okuma ve Araştırma erişimi verir
ReadReshare	string	Veri kümesindeki içeriğe Okuma ve Yeniden Paylaşma erişimi verir
ReadReshareExplore	string	Veri kümesindeki içeriğe Okuma, Yeniden Paylaşma ve Araştırma erişimi verir
ReadWrite	string	Veri kümesindeki içeriğe Okuma ve Yazma erişimi verir
ReadWriteExplore	string	Veri kümesindeki içeriğe Okuma, Yazma ve Araştırma erişimi verir
ReadWriteReshare	string	Veri kümesindeki içeriğe Okuma, Yazma ve Yeniden Paylaşma erişimi verir
ReadWriteReshareExplore	string	Veri kümesindeki içeriğe Okuma, Yazma, Yeniden Paylaşma ve Araştırma erişimi verir

Datasource

Power BI veri kaynağı

Name	Tür	Description
connectionDetails	DatasourceConnectionDetails	Veri kaynağı bağlantı ayrıntıları
connectionString	string	(Kullanım dışı) Veri kaynağı bağlantı dizesi. Yalnızca DirectQuery için kullanılabilir.
datasourceId	string	Ağ geçidine bağlı olmadığında boş olan bağlı veri kaynağı kimliği
datasourceType	string	Veri kaynağı türü
gatewayId	string	Bir ağ geçidine bağlı olmadığında boş olan bağlı ağ geçidi kimliği. Ağ geçidi kümesi kullanılırken, ağ geçidi kimliği kümedeki birincil (ilk) ağ geçidine başvurur ve ağ geçidi küme kimliğine benzer.
name	string	(Kullanım dışı) Veri kaynağı adı. Yalnızca DirectQuery için kullanılabilir.

DatasourceConnectionDetails

Power BI veri kaynağı bağlantı ayrıntıları. Veri Kaynaklarını Alma veya Grup halinde Veri Kaynakları Alma ile ilgili örneklere bakın.

Name	Tür	Description
account	string	Bağlantı hesabı
classInfo	string	Bağlantı sınıfı bilgileri
database	string	Bağlantı veritabanı
domain	string	Bağlantı etki alanı
emailAddress	string	Bağlantı e-posta adresi
kind	string	Bağlantı türü
loginServer	string	Bağlantı oturum açma sunucusu
path	string	Bağlantı yolu
server	string	Bağlantı sunucusu
url	string	Bağlantı URL'si

DefaultRetentionPolicy

Varsayılan saklama ilkesi

Name	Tür	Description
None	string	Hiçbiri
basicFIFO	string	basicFIFO

DependentDataflow

Power BI'a bağımlı veri akışı

Name	Tür	Description
groupId	string	Hedef grup kimliği
targetDataflowId	string	Hedef veri akışı kimliği

Encryption

Veri kümesi için şifreleme bilgileri

Name	Tür	Description
EncryptionStatus	EncryptionStatus	Veri kümesi şifreleme durumu

EncryptionStatus

Veri kümesi şifreleme durumu

Name	Tür	Description
InSyncWithWorkspace	string	Şifreleme desteklenir ve şifreleme ayarlarıyla eşitlenir
NotInSyncWithWorkspace	string	Şifreleme desteklenir ancak şifreleme ayarlarıyla eşitlenmez
NotSupported	string	Bu veri kümesi için şifreleme desteklenmiyor
Unknown	string	Veri kümesi bozulması nedeniyle şifreleme durumu bilinmiyor

Measure

Power BI ölçüsü

Name	Tür	Description
description	string	İsteğe bağlı. Ölçü açıklaması.
expression	string	Geçerli bir DAX ifadesi
formatString	string	İsteğe bağlı. değerin FORMAT_STRING belirtildiği gibi görüntülendiğinde nasıl biçimlendirilmesi gerektiğini açıklayan bir dize.
isHidden	boolean	İsteğe bağlı. Ölçünün gizlenip gizlenmediği.
name	string	Ölçü adı

PrincipalType

Sorumlu türü

Name	Tür	Description
App	string	Hizmet sorumlusu türü
Group	string	Grup sorumlusu türü
None	string	Sorumlu türü yok. Tüm kuruluş düzeyinde erişim için kullanın.
User	string	Kullanıcı asıl türü

Relationship

Veri kümesindeki tablolar arasındaki ilişki

Name	Tür	Varsayılan değer	Description
crossFilteringBehavior	CrossFilteringBehavior	OneDirection	İlişkinin filtre yönü
fromColumn	string		Yabancı anahtar sütununun adı
fromTable	string		Yabancı anahtar tablosunun adı
name	string		İlişki adı ve tanımlayıcısı
toColumn	string		Birincil anahtar sütununun adı
toTable	string		Birincil anahtar tablosunun adı

Row

Veri kümesindeki veri satırı

Name	Tür	Description
id	string	Benzersiz satır kimliği

ServicePrincipalProfile

Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.

Name	Tür	Description
displayName	string	Hizmet sorumlusu profil adı
id	string	Hizmet sorumlusu profil kimliği

Table

Veri kümesi tablosu

Name	Tür	Description
columns	Column[]	Bu tablonun sütun şeması
description	string	Tablo açıklaması
isHidden	boolean	İsteğe bağlı. Bu veri kümesi tablosunun gizli olup olmadığı.
measures	Measure[]	Bu tablodaki ölçüler
name	string	Tablo adı
rows	Row[]	Bu tablodaki veri satırları
source	ASMashupExpression[]	Tablo kaynağı