Items - Get Connection String

Hizmet:

Warehouse

API Sürümü:

v1

Belirtilen ambarın SQL bağlantı dizesini döndürür.

Permissions

Çağıranın ambar için okuma izinlerine sahip olması gerekir. Arayan, görüntüleyici veya daha yüksek çalışma alanı rolüne sahip olmalıdır.

Gerekli Temsilci Kapsamları

Warehouse.Read.All veya Warehouse.ReadWrite.All veya Item.Read.All veya Item.ReadWrite.All

Microsoft Entra tarafından desteklenen kimlikler

Bu API, bu bölümde listelenen Microsoft kimliklerini destekler.

Kimlik	Support
User	Yes
Hizmet sorumlusu ve Yönetilen kimlikler	Yes

Arayüz

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/warehouses/{warehouseId}/connectionString

İsteğe bağlı parametrelerle:

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/warehouses/{warehouseId}/connectionString?guestTenantId={guestTenantId}&privateLinkType={privateLinkType}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
warehouseId	path	True	string (uuid)	Ambar kimliği.
workspaceId	path	True	string (uuid)	Çalışma alanı kimliği.
guestTenantId	query		string (uuid)	Son kullanıcının kiracısı ambar kiracısından farklıysa konuk kiracı kimliği.
privateLinkType	query		PrivateLinkType	Bu bağlantı dizesinin kullandığı özel bağlantı türünü gösterir. Zaman içinde ek privateLinkType türler eklenebilir.

Yanıtlar

Name	Tür	Description
200 OK	ConnectionStringResponse	İstek başarıyla tamamlandı.
429 Too Many Requests	ErrorResponse	Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir Retry-After üst bilgi döndürür. Üst Bilgiler Retry-After: integer
Other Status Codes	ErrorResponse	Yaygın hata kodları: ItemNotFound - İstenen öğe bulunamadı. InvalidGuestTenantId - Sağlanan konuk kiracı kimliği yok.

Örnekler

Get connection string example

Örnek isteği

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/warehouses/5b218778-e7a5-4d73-8187-f10824047715/connectionString?guestTenantId=6e335e92-a2a2-4b5a-970a-bd6a89fbb765

Örnek yanıt

Durum kodu:

200

{
  "connectionString": "qvrmbuxie7we7glrekxgy6npqu-6xgyei3x2xiejip4iime6knh5m-jh0bi.zcf.datawarehouse.fabric.microsoft.com"
}

Tanımlar

Name	Description
ConnectionStringResponse	Bu ambarı içeren çalışma alanının SQL bağlantı dizesi.
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
PrivateLinkType	Bu bağlantı dizesinin kullandığı özel bağlantı türünü gösterir. Zaman içinde ek privateLinkType türler eklenebilir.

ConnectionStringResponse

Nesne

Bu ambarı içeren çalışma alanının SQL bağlantı dizesi.

Name	Tür	Description
connectionString	string	Bu ambarı içeren çalışma alanının SQL bağlantı dizesi.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Name	Tür	Description
resourceId	string	Hataya dahil olan kaynak kimliği.
resourceType	string	Hataya dahil olan kaynağın türü.

ErrorResponse

Nesne

Hata yanıtı.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.
requestId	string (uuid)	Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Nesne

Hata yanıtı ayrıntıları.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

PrivateLinkType

Numaralandırma

Bu bağlantı dizesinin kullandığı özel bağlantı türünü gösterir. Zaman içinde ek privateLinkType türler eklenebilir.

Değer	Description
None	Özel bağlantı yok (varsayılan).
Workspace	Çalışma alanı özel Bağlantısı.