SDK versions provided by Quick BI - Quick BI - Alibaba Cloud Dokümantasyon Merkezi

Bu konuda, Quick BI'nin sunduğu yazılım geliştirme seti (SDK) sürümleri açıklanır ve en güncel sürümlerin nasıl edinileceği anlatılır.

SDK'ya genel bakış

Giriş

Görsel analitik için Quick BI SDK'sı, kapsüllenmiş bir dizi API işlemi sağlar. Kimlik doğrulaması için AccessKey çiftini kullanır ve kaynakların oluşturulup yönetilmesini basitleştiren otomatik imzalama gibi özellikler sunar.

Görsel analitik için Quick BI yazılım geliştirme seti (SDK), API işlemlerini kapsüller. Çağrı yapanları tanımlamak amacıyla AccessKey çiftini kullanır ve kaynaklarınızı oluşturup yönetmenize yardımcı olmak üzere otomatik imzalama gibi özellikler sağlar. Quick BI görsel analitik özelliklerini kullanmak için hem Quick BI SDK'sını hem de Alibaba Cloud çekirdek kitaplığını yüklemeniz gerekir. Örneğin, Java SDK'sını kullanıyorsanız aliyun-java-sdk-core ve aliyun-java-sdk-quickbi-public öğelerini indirmeniz gerekir.

Notlar

SDK'yı indirmek ve kullanım talimatlarını görüntülemek için Alibaba Cloud SDK sayfasına gidin.
Kullanılabilir API işlemlerinin listesi için bkz. API referansı.
Alibaba Cloud hesabınızın AccessKey ID'sini ve AccessKey secret değerini edinin.

Daha fazla bilgi için bkz. AccessKey çifti oluşturun.
Bir SDK kullanarak API işlemlerini çağırmak için aşağıdaki iki koşulu karşılamanız gerekir:
- Alibaba Cloud hesabınızla Quick BI'de en az bir kez oturum açmış olmanız gerekir.
- Alibaba Cloud hesabınıza Quick BI'de organizasyon yöneticisi rolünün atanmış olması gerekir. Bir yönetici, Yönetim Platformu sayfasında tüm API işlemlerini çağırma iznini yönetici olmayan kullanıcılara da verebilir. Daha fazla bilgi için bkz. Genel Bakış > Erişim kontrolü.

Desteklenen programlama dilleri

Quick BI; Java, Python ve C# gibi dillerde yazılım geliştirme setleri (SDK'lar) ile geliştirmeyi destekler. SDK'lar hakkında daha fazla bilgi için Alibaba Cloud Açık Platformu adresini ziyaret edin.

Sürüm kılavuzu

Yayınlanan Sürüm	Yayınlanma zamanı	Değişiklik açıklaması
2.0.0	2022-03-04	Bölgeye özgü uç noktalarla birlikte API V2 yayınlandı. Yayınlanan işlemler, orijinal API listesindeki tüm işlemleri kapsar. Not API V2'nin yayınlanmasının ardından orijinal API listesi artık korunmamaktadır. Tüm yeni API işlemleri V2'ye eklenir.

İlgili bağlantılar

Alibaba Cloud Geliştirici Merkezi, sık kullanılan programlama dilleri için SDK'lar sağlar. Ayrıca hızlı başlangıç öğreticileri ve açık kaynak projelerin listeleri gibi bilgiler sunar. Daha fazla bilgi için bkz. Alibaba Cloud Geliştirici Merkezi.

SDK çağrı yöntemleri

SDK'yı çağırırken aşağıdaki hususlara dikkat edin:

Alibaba Cloud hesabınıza karşılık gelen AccessKey ID ve AccessKey secret değerlerini kullanarak bir DefaultAcsClient örneği oluşturun ve başlatın. Aksi takdirde şu hata raporlanır: code: 404, Specified access key is not found. request id: AA7FE476-F206-5C52-95B3-DF35CD30D468.
AccessKey çifti, Quick BI'de organizasyon yöneticisi rolüne sahip olan ve Quick BI'de en az bir kez oturum açmış bir Alibaba Cloud hesabına ait olmalıdır. AccessKey çiftini ihtiyaçlarınıza göre belirtin.

SDK'nın nasıl çağrılacağı hakkında daha fazla bilgi için bkz. SDK belgeleri.

API işlemi kısıtlaması

Önemli

Aşağıdaki API işlemlerinin sürümü 2022-01-01 şeklindedir.
Public Cloud ve Finansal Cloud'da dağıtılan Quick BI kullanıcıları aşağıdaki API işlemlerini çağırabilir.
API çağrıları yalnızca Quick BI Professional ve üst sürümler tarafından desteklenir.

Kategori	API Adı	Açıklama	Saniye Başına Sorgu Sayısı (SBS)	Zaman aşımı (saniye)
Organizasyon ve kullanıcı yönetimi	AddUser	Bir organizasyona üye ekler.	50	10
	UpdateUser	Bir organizasyondaki belirli bir üyenin bilgilerini günceller.	50	10
	QueryUserList	Bir organizasyondaki üyelerin listesini sorgular.	30	10
	DeleteUser	Belirtilen bir kullanıcıyı bir organizasyondan siler.	50	10
	QueryUserInfoByUserId	Bir organizasyondaki bir üyenin bilgilerini kullanıcı kimliğine göre sorgular.	30	10
	QueryUserInfoByAccount	Bir organizasyondaki bir üyenin bilgilerini Alibaba Cloud hesap kimliği veya adına göre sorgular.	30	10
Kullanıcı etiketi yönetimi	AddUserTagMeta	Bir organizasyondaki bir üyenin etiketleri için meta veri ekler.	50	10
	DeleteUserTagMeta	Bir organizasyondaki bir üyenin etiketlerinin meta verilerini siler.	50	10
	QueryUserTagMetaList	Bir organizasyondaki üyelerin etiketlerinin meta veri listesini sorgular.	30	10
	UpdateUserTagValue	Bir organizasyondaki bir üyenin etiket değerlerini değiştirir.	50	10
	QueryUserTagValueList	Belirtilen bir kullanıcı için etiket değeri listesini sorgular.	30	10
	UpdateUserTagMeta	Bir organizasyondaki bir üyenin etiketlerinin meta verilerini günceller.	50	10
Organizasyon ve kullanıcı grubu yönetimi	AddUserGroupMember	Bir organizasyonun üyesini belirtilen bir kullanıcı grubuna ekler.	50	10
	AddUserGroupMembers	Birden çok kullanıcıyı toplu olarak belirtilen bir kullanıcı grubuna ekler.	50	10
	DeleteUserGroupMember	Belirtilen bir üyeyi belirtilen bir kullanıcı grubundan siler.	50	10
	CreateUserGroup	Belirtilen bir organizasyonda bir kullanıcı grubu oluşturur.	50	10
	DeleteUserGroup	Belirtilen bir organizasyondan bir kullanıcı grubunu siler.	50	10
	UpdateUserGroup	Bir organizasyondaki belirtilen bir kullanıcı grubunun bilgilerini günceller.	50	10
	QueryUserGroupMember	Bir kullanıcı grubundaki üyelerin listesini sorgular.	30	10
	QueryUserGroupListByParentId	Belirtilen bir üst kullanıcı grubunun alt kullanıcı gruplarının bilgilerini sorgular.	30	10
	GetUserGroupInfo	Kullanıcı grubu adının anahtar sözcüğünü kullanarak kullanıcı gruplarında arama yapar.	30	10
	ListUserGroupsByUserId	Bir kullanıcının ait olduğu kullanıcı gruplarının listesini sorgular.	30	10
	WithdrawAllUserGroups	Bir kullanıcıyı tüm kullanıcı gruplarından kaldırır.	50	10
	DeleteUserGroupMembers	Birden çok kullanıcıyı toplu olarak kullanıcı gruplarından kaldırır.	50	10
	ListByUserGroupId	Kullanıcı grubu kimliğini kullanarak birden çok kullanıcı grubunun bilgilerini tek seferde sorgular.	50	10
Rapor paylaşımı ve yetkilendirme	QueryShareList	Yetkilendirme listesini sorgular.	30	10
	AddShareReport	Bir rapora yetkilendirme ilkesi ekler.	50	10
	QuerySharesToUserList	Bir kullanıcıya yetkilendirilen çalışmaların listesini sorgular.	30	10
	CancelReportShare	Bir raporun yetkilendirme ilkesini siler.	50	10
BI portal menüsü yetkilendirmesi	ListPortalMenus	BI portal menülerinin listesini sorgular.	30	10
	ListPortalMenuAuthorization	Bir BI portal menüsünün yetkilendirme listesini sorgular.	30	10
	AuthorizeMenu	BI portal menülerine toplu olarak yetkilendirme ekler.	50	10
	CancelAuthorizationMenu	BI portal menülerinin yetkilendirmelerini toplu olarak iptal eder.	50	10
	ChangeVisibilityModel	Bir BI portal menüsünün görünürlüğünü değiştirir. Menüyü yalnızca yetkilendirilmiş kullanıcılara görünür şekilde ayarlayabilirsiniz.	50	10
Satır düzeyinde izin yönetimi	QueryDatasetSwitchInfo	Bir veri kümesi için satır düzeyi izinler anahtarının durumunu sorgular.	30	10
	UpdateDataLevelPermissionStatus	Bir veri kümesi için satır ve sütun düzeyi izinleri etkinleştirir veya devre dışı bırakır.	50	10
	ListCubeDataLevelPermissionConfig	Bir veri kümesi için satır ve sütun düzeyi izin yapılandırmalarını sorgular.	30	10
	SetDataLevelPermissionRuleConfig	Bir veri kümesindeki satır ve sütun düzeyi izinler için bir kural yapılandırır.	50	10
	DeleteDataLevelRuleConfig	Bir veri kümesindeki satır ve sütun düzeyi izinler için bir kuralı siler.	50	10
	AddDataLevelPermissionRuleUsers	Bir kurala göre satır düzeyi izinler verilen kullanıcıları artımlı olarak ekler.	50	10
	DeleteDataLevelPermissionRuleUsers	Bir kurala göre satır düzeyi izinler verilen kullanıcıları siler.	50	10
	SetDataLevelPermissionExtraConfig	Satır veya sütun düzeyi izinler için ek yapılandırmalar belirtir.	50	10
	ListDataLevelPermissionWhiteList	Bir veri kümesi için satır ve sütun düzeyi izinlerin izin listesini sorgular.	30	10
	SetDataLevelPermissionWhiteList	Satır ve sütun düzeyi izinler için bir izin listesi yapılandırır.	50	10
	AddDataLevelPermissionWhiteList	Satır ve sütun düzeyi izinler için bir izin listesini artımlı olarak yapılandırır.	50	10
Çalışma Alanı Yönetimi	UpdateWorkspaceUsersRole	Bir çalışma alanındaki üyelerin rollerini değiştirir.	50	10
	QueryWorkspaceUserList	Belirtilen bir çalışma alanındaki üyelerin listesini sorgular.	30	10
	DeleteUserFromWorkspace	Belirtilen bir çalışma alanından bir üyeyi siler.	50	10
	QueryOrganizationWorkspaceList	Geçerli organizasyondaki çalışma alanlarının listesini sorgular.	30	10
	AddUserToWorkspace	Belirtilen bir çalışma alanına bir üye ekler.	50	10
	AddWorkspaceUsers	Birden çok üyeyi toplu olarak belirtilen bir çalışma alanına ekler.	50	10
	QueryUserRoleInfoInWorkspace	Belirtilen bir çalışma alanındaki üyelerin rol bilgilerini sorgular.	30	10
	UpdateWorkspaceUserRole	Bir çalışma alanındaki üyelerin rol bilgilerini toplu olarak günceller.	50	10
Rapor kaynağı yönetimi	QueryWorksByOrganization	Bir organizasyondaki raporların listesini sorgular.	30	10
	QueryWorksByWorkspace	Bir organizasyonun belirtilen bir çalışma alanındaki raporların listesini sorgular.	30	10
	QueryReadableResourcesListByUserId	Bir kullanıcının görüntüleme iznine sahip olduğu raporların listesini sorgular.	30	10
	CheckReadable	Bir kullanıcının bir raporu görüntüleme iznine sahip olup olmadığını denetler.	50	10
	QueryEmbeddedInfo	Bir organizasyondaki raporların yerleştirme bilgilerini sorgular.	30	10
	UpdateEmbeddedStatus	Bir raporun yerleştirme durumunu değiştirir.	50	10
	QueryWorks	Bir raporun bilgilerini sorgular.	30	10
	QueryWorksBloodRelationship	Belirtilen bir raporun veri soy ağacını sorgular.	30	10
Veri kümesi kaynağı yönetimi	QueryDatasetList	Belirtilen bir çalışma alanındaki veri kümelerinin listesini sorgular.	30	10
	QueryDatasetDetailInfo	Belirtilen bir veri kümesinin ayrıntılarını sorgular.	30	10
	QueryDatasetInfo	Bir veri kümesinin ayrıntılarını sorgular.	30	10
Favorilerin Yönetimi	ListCollections	Favorilerin listesini sorgular.	30	10
	SaveFavorites	Bir çalışmayı favorilere ekler.	50	10
	CancelCollection	Bir çalışmayı favorilerden kaldırır.	50	10
Ana sayfa yönetimi	ListFavoriteReports	Belirtilen bir kullanıcı için Panolarım sayfasındaki yetkilendirilen çalışmaların listesini sorgular.	30	10
	ListSharedReports	Belirtilen bir kullanıcı için Panolarım sayfasındaki favori çalışmaların listesini sorgular.	30	10
	ListRecentViewReports	Belirtilen bir kullanıcı için Panolarım sayfasındaki son veya sık görüntülenmiş çalışmaların listesini sorgular.	30	10
DataService Studio	QueryDataService	DataService Studio'da oluşturulan bir API işlemini çağırır.	10	60
Yerleştirilmiş analitik	CreateTicket	Üçüncü taraf yerleştirme için bir bilet oluşturur.	50	10
	QueryTicketInfo	Bir raporu yerleştirmek için kullanılan bir biletin ayrıntılarını sorgular.	30	10
	DeleteTicket	Bir raporu yerleştirmek için kullanılan bir bileti siler.	50	10
	DelayTicketExpireTime	Bir raporu yerleştirmek için kullanılan bir biletin sona erme süresini günceller.	50	10
	UpdateTicketNum	Bir raporu yerleştirmek için kullanılabilecek bilet sayısını günceller.	50	10
Açık onay	ResultCallback	Özel onay iş akışları için bir geri arama API işlemidir. Bu işlemi Quick BI'deki onay iş akışlarını işlemek için kullanabilirsiniz.	30	10

SDK sürümünü görüntüleyin

pom.xml dosyasında, version değerinin SDK indirme adresindeki en güncel sürüm olduğundan emin olun.

SDK sürümünü https://mvnrepository.com/artifact/com.aliyun/aliyun-java-sdk-quickbi-public adresinden görüntüleyebilirsiniz.

Saniye başına eşzamanlı istek sayısının kısıtlama eşiğini aşmasını önleme

Sorun açıklaması: Performans ve güvenlik amaçlarıyla, Public Cloud'da dağıtılan Quick BI'nin API işlemleri varsayılan olarak kısıtlanır. Eşzamanlı iş parçacıkları kullanarak API işlemlerini çağırırsanız ve saniye başına gerçek sorgu sayısı (SBS) kısıtlama eşiğini aşarsa istekler başarısız olur.

Çözüm: API isteklerinin SBS değerini sınırlamak için Google Guava bileşeninin RateLimiter sınıfını kullanabilirsiniz.

Java projenizi yönetmek için Maven kullanıyorsanız Maven bağımlılığını pom.xml dosyasına ekleyin.
```
<dependency>
    <groupId>com.google.guava</groupId>
    <artifactId>guava</artifactId>
    <version>${google.guava.version}</version>
</dependency>
```
Not
pom.xml dosyasında version değerinin indirme adresindeki en güncel sürüm olduğundan emin olun. En güncel sürüm için bkz. Guava: Google Core Libraries For Java.

RateLimiter oluşturun ve kullanın.

RateLimiter örneği oluşturmak için create() fabrika yöntemini kullanabilirsiniz. Daha fazla bilgi için bkz. https://www.baeldung.com/guava-rate-limiter.

// Create a RateLimiter for throttling with a limit of 30 QPS.
RateLimiter rateLimiter = RateLimiter.create(30);
// Obtain a permit. If the QPS exceeds 30, the request is blocked and must wait.
rateLimiter.acquire();
// An API request can be sent only after a permit is obtained.
doSomeAPIRequest();

Not

Saniye başına sorgu sayısı (SBS), saniyede işlenen istek veya görev sayısıdır.

Eşzamanlılık, sistemin aynı anda işlediği istek veya görev sayısıdır.

SBS = Eşzamanlılık/Ortalama yanıt süresi.