Data Sources - Get

Usługa:: Search Service

Wersja interfejsu API:: 2023-11-01

Pobiera definicję źródła danych.

GET {endpoint}/datasources('{dataSourceName}')?api-version=2023-11-01

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
dataSourceName	path	True	string	Nazwa źródła danych do pobrania.
endpoint	path	True	string	Adres URL punktu końcowego usługi wyszukiwania.
api-version	query	True	string	Wersja interfejsu API klienta.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
x-ms-client-request-id		string (uuid)	Identyfikator śledzenia wysłany z żądaniem, aby ułatwić debugowanie.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	SearchIndexerDataSource
Other Status Codes	SearchError	Odpowiedź na błąd.

Przykłady

SearchServiceGetDataSource

Przykładowe żądanie

HTTP

GET https://myservice.search.windows.net/datasources('mydatasource')?api-version=2023-11-01

Przykładowa odpowiedź

Kod stanu:: 200

{
  "name": "mydocdbdatasource",
  "description": "My Cosmos DB data source.",
  "type": "cosmosdb",
  "credentials": {
    "connectionString": null
  },
  "container": {
    "name": "myDocDbCollectionId",
    "query": "SELECT c.id, c.userId, tag, c._ts FROM c JOIN tag IN c.tags WHERE c._ts >= @HighWaterMark ORDER BY c._ts"
  },
  "dataChangeDetectionPolicy": {
    "@odata.type": "#Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy",
    "highWaterMarkColumnName": "_ts"
  },
  "dataDeletionDetectionPolicy": {
    "@odata.type": "#Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy",
    "softDeleteColumnName": "isDeleted",
    "softDeleteMarkerValue": "true"
  },
  "encryptionKey": {
    "keyVaultKeyName": "myKeyName",
    "keyVaultKeyVersion": "myKeyVersion",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": null
    }
  }
}

Definicje

Nazwa	Opis
AzureActiveDirectoryApplicationCredentials	Poświadczenia zarejestrowanej aplikacji utworzonej dla usługi wyszukiwania używane do uwierzytelnionego dostępu do kluczy szyfrowania przechowywanych w usłudze Azure Key Vault.
DataSourceCredentials	Reprezentuje poświadczenia, których można użyć do nawiązania połączenia ze źródłem danych.
HighWaterMarkChangeDetectionPolicy	Definiuje zasady wykrywania zmian danych, które przechwytują zmiany na podstawie wartości kolumny wysokiego znacznika wody.
SearchError	Opisuje warunek błędu interfejsu API.
SearchIndexerDataContainer	Reprezentuje informacje o jednostce (takiej jak tabela Azure SQL lub kolekcja CosmosDB), które będą indeksowane.
SearchIndexerDataSource	Reprezentuje definicję źródła danych, która może służyć do konfigurowania indeksatora.
SearchIndexerDataSourceType	Definiuje typ źródła danych.
SearchResourceEncryptionKey	Klucz szyfrowania zarządzany przez klienta w usłudze Azure Key Vault. Klucze tworzone i zarządzane mogą służyć do szyfrowania lub odszyfrowywania danych magazynowanych w usłudze wyszukiwania, takich jak indeksy i mapy synonimów.
SoftDeleteColumnDeletionDetectionPolicy	Definiuje zasady wykrywania usuwania danych, które implementują strategię usuwania nietrwałego. Określa, czy element powinien zostać usunięty na podstawie wartości wyznaczonej kolumny "usuwanie nietrwałe".
SqlIntegratedChangeTrackingPolicy	Definiuje zasady wykrywania zmian danych, które przechwytują zmiany przy użyciu funkcji zintegrowanego śledzenia zmian usługi Azure SQL Database.

AzureActiveDirectoryApplicationCredentials

Objekt

Poświadczenia zarejestrowanej aplikacji utworzonej dla usługi wyszukiwania używane do uwierzytelnionego dostępu do kluczy szyfrowania przechowywanych w usłudze Azure Key Vault.

Nazwa	Typ	Opis
applicationId	string	Identyfikator aplikacji usługi AAD, któremu udzielono wymaganych uprawnień dostępu do usługi Azure Key Vault, która ma być używana podczas szyfrowania danych magazynowanych. Identyfikator aplikacji nie powinien być mylony z identyfikatorem obiektu aplikacji usługi AAD.
applicationSecret	string	Klucz uwierzytelniania określonej aplikacji usługi AAD.

DataSourceCredentials

Objekt

Reprezentuje poświadczenia, których można użyć do nawiązania połączenia ze źródłem danych.

Nazwa	Typ	Opis
connectionString	string	Parametry połączenia dla źródła danych. Ustaw wartość `<unchanged>` (z nawiasami kwadratowymi), jeśli nie chcesz zaktualizować parametrów połączenia. Ustaw wartość na `<redacted>`, jeśli chcesz usunąć wartość parametrów połączenia ze źródła danych.

HighWaterMarkChangeDetectionPolicy

Objekt

Definiuje zasady wykrywania zmian danych, które przechwytują zmiany na podstawie wartości kolumny wysokiego znacznika wody.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy	Fragment identyfikatora URI określający typ zasad wykrywania zmian danych.
highWaterMarkColumnName	string	Nazwa kolumny z wysokim znacznikiem wody.

SearchError

Objekt

Opisuje warunek błędu interfejsu API.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
details	SearchError[]	Tablica szczegółów dotyczących określonych błędów, które doprowadziły do tego zgłoszonego błędu.
message	string	Czytelna dla człowieka reprezentacja błędu.

SearchIndexerDataContainer

Objekt

Reprezentuje informacje o jednostce (takiej jak tabela Azure SQL lub kolekcja CosmosDB), które będą indeksowane.

Nazwa	Typ	Opis
name	string	Nazwa tabeli lub widoku (dla źródła danych Usługi Azure SQL) lub kolekcji (dla źródła danych usługi CosmosDB), które zostaną indeksowane.
query	string	Zapytanie stosowane do tego kontenera danych. Składnia i znaczenie tego parametru są specyficzne dla źródła danych. Nieobsługiwane przez źródła danych usługi Azure SQL.

SearchIndexerDataSource

Objekt

Reprezentuje definicję źródła danych, która może służyć do konfigurowania indeksatora.

Nazwa	Typ	Opis
@odata.etag	string	Element ETag źródła danych.
container	SearchIndexerDataContainer	Kontener danych dla źródła danych.
credentials	DataSourceCredentials	Poświadczenia źródła danych.
dataChangeDetectionPolicy	DataChangeDetectionPolicy: HighWaterMarkChangeDetectionPolicy SqlIntegratedChangeTrackingPolicy	Zasady wykrywania zmian danych dla źródła danych.
dataDeletionDetectionPolicy	DataDeletionDetectionPolicy: SoftDeleteColumnDeletionDetectionPolicy	Zasady wykrywania usuwania danych dla źródła danych.
description	string	Opis źródła danych.
encryptionKey	SearchResourceEncryptionKey	Opis klucza szyfrowania utworzonego w usłudze Azure Key Vault. Ten klucz służy do zapewnienia dodatkowego poziomu szyfrowania w spoczynku dla definicji źródła danych, gdy chcesz mieć pełną pewność, że nikt, nawet firma Microsoft, nie może odszyfrować definicję źródła danych. Po zaszyfrowaniu definicji źródła danych zawsze pozostanie ona zaszyfrowana. Usługa wyszukiwania zignoruje próby ustawienia tej właściwości na wartość null. Tę właściwość można zmienić w razie potrzeby, jeśli chcesz obrócić klucz szyfrowania; Definicja źródła danych nie będzie miała wpływu. Szyfrowanie za pomocą kluczy zarządzanych przez klienta nie jest dostępne dla bezpłatnych usług wyszukiwania i jest dostępne tylko dla płatnych usług utworzonych w dniu 1 stycznia 2019 r. lub po 1 stycznia 2019 r.
name	string	Nazwa źródła danych.
type	SearchIndexerDataSourceType	Typ źródła danych.

SearchIndexerDataSourceType

Wyliczenie

Definiuje typ źródła danych.

Wartość	Opis
azuresql	Wskazuje źródło danych usługi Azure SQL.
cosmosdb	Wskazuje źródło danych usługi CosmosDB.
azureblob	Wskazuje źródło danych obiektu blob platformy Azure.
azuretable	Wskazuje źródło danych tabeli platformy Azure.
mysql	Wskazuje źródło danych MySql.
adlsgen2	Wskazuje źródło danych usługi ADLS Gen2.

SearchResourceEncryptionKey

Objekt

Klucz szyfrowania zarządzany przez klienta w usłudze Azure Key Vault. Klucze tworzone i zarządzane mogą służyć do szyfrowania lub odszyfrowywania danych magazynowanych w usłudze wyszukiwania, takich jak indeksy i mapy synonimów.

Nazwa	Typ	Opis
accessCredentials	AzureActiveDirectoryApplicationCredentials	Opcjonalne poświadczenia usługi Azure Active Directory używane do uzyskiwania dostępu do usługi Azure Key Vault. Nie jest wymagane, jeśli zamiast tego używasz tożsamości zarządzanej.
keyVaultKeyName	string	Nazwa klucza usługi Azure Key Vault, który ma być używany do szyfrowania danych magazynowanych.
keyVaultKeyVersion	string	Wersja klucza usługi Azure Key Vault, która ma być używana do szyfrowania danych magazynowanych.
keyVaultUri	string	Identyfikator URI usługi Azure Key Vault, nazywany również nazwą DNS, który zawiera klucz używany do szyfrowania danych magazynowanych. Przykładowy identyfikator URI może być `https://my-keyvault-name.vault.azure.net`.

SoftDeleteColumnDeletionDetectionPolicy

Objekt

Definiuje zasady wykrywania usuwania danych, które implementują strategię usuwania nietrwałego. Określa, czy element powinien zostać usunięty na podstawie wartości wyznaczonej kolumny "usuwanie nietrwałe".

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy	Fragment identyfikatora URI określający typ zasad wykrywania usuwania danych.
softDeleteColumnName	string	Nazwa kolumny do użycia do wykrywania usuwania nietrwałego.
softDeleteMarkerValue	string	Wartość znacznika identyfikującą element jako usunięty.

SqlIntegratedChangeTrackingPolicy

Objekt

Definiuje zasady wykrywania zmian danych, które przechwytują zmiany przy użyciu funkcji zintegrowanego śledzenia zmian usługi Azure SQL Database.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Azure.Search.SqlIntegratedChangeTrackingPolicy	Fragment identyfikatora URI określający typ zasad wykrywania zmian danych.