Datasets - Get Dataset

Referensi

Service:: Power BI REST APIs

API Version:: v1.0

Mengembalikan himpunan data yang ditentukan dari Ruang kerja saya.

Cakupan yang Diperlukan

Dataset.ReadWrite.All atau Dataset.Read.All

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
datasetId	path	True	string	ID himpunan data

Respons

Nama	Jenis	Deskripsi
200 OK	Dataset	OK

Contoh

Example

Sample Request

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

Sample Response

Status code:: 200

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

Definisi

Nama	Deskripsi
Dataset	Himpunan data Power BI. API mengembalikan subset dari daftar properti himpunan data berikut. Subset bergantung pada API yang disebut, izin pemanggil, dan ketersediaan data dalam database Power BI.
DatasetQueryScaleOutSettings	Pengaturan peluasan skala kueri himpunan data
DatasetUser	Entri kanan akses pengguna Power BI untuk himpunan data
DatasetUserAccessRight	Hak akses yang dimiliki pengguna untuk himpunan data (tingkat izin)
DependentDataflow	Aliran data dependen Power BI
Encryption	Informasi enkripsi untuk himpunan data
EncryptionStatus	Status enkripsi himpunan data
PrincipalType	Jenis utama
ServicePrincipalProfile	Profil utama layanan Power BI. Hanya relevan untuk solusi multipenyewa Power BI Embedded.

Dataset

Himpunan data Power BI. API mengembalikan subset dari daftar properti himpunan data berikut. Subset bergantung pada API yang disebut, izin pemanggil, dan ketersediaan data dalam database Power BI.

Nama	Jenis	Deskripsi
ContentProviderType	string	Jenis penyedia konten untuk himpunan data
CreateReportEmbedURL	string	URL semat laporan pembuatan himpunan data
CreatedDate	string	Tanggal dan waktu pembuatan himpunan data
Encryption	Encryption	Informasi enkripsi himpunan data. Hanya berlaku ketika `$expand` ditentukan.
IsEffectiveIdentityRequired	boolean	Apakah himpunan data memerlukan identitas yang efektif, yang harus Anda kirim dalam panggilan GENERATEToken API.
IsEffectiveIdentityRolesRequired	boolean	Apakah keamanan tingkat baris ditentukan di dalam file .pbix Power BI. Jika demikian, Anda harus menentukan peran.
IsInPlaceSharingEnabled	boolean	Apakah himpunan data dapat dibagikan dengan pengguna eksternal untuk dikonsumsi di penyewa mereka sendiri
IsOnPremGatewayRequired	boolean	Apakah himpunan data memerlukan gateway data lokal
IsRefreshable	boolean	Apakah himpunan data dapat disegarkan atau tidak. Himpunan data yang dapat disegarkan Power BI adalah himpunan data yang telah di-refresh setidaknya sekali, atau di mana jadwal refresh yang valid ada.
QnaEmbedURL	string	Himpunan data Q&URL semat
addRowsAPIEnabled	boolean	Apakah himpunan data memungkinkan penambahan baris baru
configuredBy	string	Pemilik himpunan data
description	string	Deskripsi himpunan data
id	string	ID himpunan data
name	string	Nama himpunan data
queryScaleOutSettings	DatasetQueryScaleOutSettings	Pengaturan peluasan skala kueri himpunan data
targetStorageMode	string	Mode penyimpanan himpunan data
upstreamDataflows	DependentDataflow[]	Daftar semua aliran data yang bergantung pada item ini
users	DatasetUser[]	(Nilai kosong) Detail akses pengguna himpunan data. Properti ini akan dihapus dari respons payload dalam rilis mendatang. Anda dapat mengambil informasi pengguna tentang item Power BI (seperti laporan atau dasbor) dengan menggunakan Get Dataset Users as Admin API, atau PostWorkspaceInfo API dengan `getArtifactUsers` parameter .
webUrl	string	URL web himpunan data

DatasetQueryScaleOutSettings

Pengaturan peluasan skala kueri himpunan data

Nama	Jenis	Deskripsi
autoSyncReadOnlyReplicas	boolean	Apakah himpunan data secara otomatis menyinkronkan replika baca-saja
maxReadOnlyReplicas	integer	Jumlah maksimum replika baca-saja untuk himpunan data (0-64, -1 untuk jumlah replika otomatis)

DatasetUser

Entri kanan akses pengguna Power BI untuk himpunan data

Nama	Jenis	Deskripsi
datasetUserAccessRight	DatasetUserAccessRight	Hak akses yang dimiliki pengguna untuk himpunan data (tingkat izin)
displayName	string	Nama tampilan prinsipal
emailAddress	string	Alamat email pengguna
graphId	string	Pengidentifikasi prinsipal di Microsoft Graph. Hanya tersedia untuk API admin.
identifier	string	Pengidentifikasi prinsipal
principalType	PrincipalType	Jenis utama
profile	ServicePrincipalProfile	Profil utama layanan Power BI. Hanya relevan untuk solusi multipenyewa Power BI Embedded.
userType	string	Jenis pengguna.

DatasetUserAccessRight

Hak akses yang dimiliki pengguna untuk himpunan data (tingkat izin)

Nama	Jenis	Deskripsi
None	string	Menghapus izin ke konten dalam himpunan data
Read	string	Memberikan akses Baca ke konten dalam himpunan data
ReadExplore	string	Memberikan akses Baca dan Jelajahi ke konten dalam himpunan data
ReadReshare	string	Memberikan akses Baca dan Reshare ke konten dalam himpunan data
ReadReshareExplore	string	Memberikan akses Baca, Reshare, dan Jelajahi ke konten dalam himpunan data
ReadWrite	string	Memberikan akses Baca dan Tulis ke konten dalam himpunan data
ReadWriteExplore	string	Memberikan akses Baca, Tulis, dan Jelajahi ke konten dalam himpunan data
ReadWriteReshare	string	Memberikan akses Baca, Tulis, dan Reshare ke konten dalam himpunan data
ReadWriteReshareExplore	string	Memberikan akses Baca, Tulis, Reshare, dan Jelajahi konten dalam himpunan data

DependentDataflow

Aliran data dependen Power BI

Nama	Jenis	Deskripsi
groupId	string	ID grup target
targetDataflowId	string	ID aliran data target

Encryption

Informasi enkripsi untuk himpunan data

Nama	Jenis	Deskripsi
EncryptionStatus	EncryptionStatus	Status enkripsi himpunan data

EncryptionStatus

Status enkripsi himpunan data

Nama	Jenis	Deskripsi
InSyncWithWorkspace	string	Enkripsi didukung dan sinkron dengan pengaturan enkripsi
NotInSyncWithWorkspace	string	Enkripsi didukung tetapi tidak sinkron dengan pengaturan enkripsi
NotSupported	string	Enkripsi tidak didukung untuk himpunan data ini
Unknown	string	Status enkripsi tidak diketahui karena kerusakan himpunan data

PrincipalType

Jenis utama

Nama	Jenis	Deskripsi
App	string	Jenis perwakilan layanan
Group	string	Jenis utama grup
None	string	Tidak ada jenis utama. Gunakan untuk seluruh akses tingkat organisasi.
User	string	Jenis prinsipal pengguna

ServicePrincipalProfile

Profil utama layanan Power BI. Hanya relevan untuk solusi multipenyewa Power BI Embedded.

Nama	Jenis	Deskripsi
displayName	string	Nama profil perwakilan layanan
id	string	ID profil perwakilan layanan

Bagikan melalui