Indexers - Get

Başvuru

Service:: Search Service

API Version:: 2023-11-01

Dizin oluşturucu tanımını alır.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string	Arama hizmetinin uç nokta URL'si.
indexerName	path	True	string	Alınacak dizin oluşturucunun adı.
api-version	query	True	string	İstemci Api Sürümü.

İstek Başlığı

Name	Gerekli	Tür	Description
x-ms-client-request-id		string uuid	Hata ayıklamaya yardımcı olmak için istekle birlikte gönderilen izleme kimliği.

Yanıtlar

Name	Tür	Description
200 OK	SearchIndexer
Other Status Codes	SearchError	Hata yanıtı.

Örnekler

SearchServiceGetIndexer

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "name": "myindexer",
  "description": "a cool indexer",
  "dataSourceName": "mydatasource",
  "targetIndexName": "orders",
  "schedule": {
    "interval": "PT1H",
    "startTime": "2015-01-01T00:00:00Z"
  },
  "parameters": {
    "maxFailedItems": 10,
    "maxFailedItemsPerBatch": 5
  },
  "fieldMappings": [],
  "disabled": false,
  "encryptionKey": {
    "keyVaultKeyName": "myKeyName",
    "keyVaultKeyVersion": "myKeyVersion",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": null
    }
  }
}

Tanımlar

Name	Description
AzureActiveDirectoryApplicationCredentials	Arama hizmetiniz için oluşturulan ve Azure Key Vault'de depolanan şifreleme anahtarlarına kimliği doğrulanmış erişim için kullanılan kayıtlı bir uygulamanın kimlik bilgileri.
BlobIndexerDataToExtract	Azure blob depolamadan ayıklanması gereken verileri belirtir ve "imageAction" "none" dışında bir değere ayarlandığında dizin oluşturucuya görüntü içeriğinden hangi verilerin ayıklandığını bildirir. Bu, azure bloblarındaki .PDF veya başka bir uygulamadaki ekli görüntü içeriği ya da .jpg ve .png gibi görüntü dosyaları için geçerlidir.
BlobIndexerImageAction	Azure blob depolamada ekli görüntülerin ve görüntü dosyalarının nasıl işleneceğini belirler. "imageAction" yapılandırmasını "none" dışında bir değere ayarlamak için bir beceri kümesinin de bu dizin oluşturucuya eklenmesi gerekir.
BlobIndexerParsingMode	Azure blob veri kaynağından dizin oluşturma için ayrıştırma modunu temsil eder.
BlobIndexerPDFTextRotationAlgorithm	Azure blob depolamadaki PDF dosyalarından metin ayıklama algoritmasını belirler.
FieldMapping	Veri kaynağındaki bir alan ile dizindeki hedef alan arasında eşleme tanımlar.
FieldMappingFunction	Dizin oluşturmadan önce veri kaynağından bir değeri dönüştüren bir işlevi temsil eder.
IndexerExecutionEnvironment	Dizin oluşturucunun yürütülmesi gereken ortamı belirtir.
IndexingParameters	Dizin oluşturucu yürütme parametrelerini temsil eder.
IndexingParametersConfiguration	Dizin oluşturucuya özgü yapılandırma özelliklerinin sözlüğü. Her ad, belirli bir özelliğin adıdır. Her değer ilkel türde olmalıdır.
IndexingSchedule	Dizin oluşturucu yürütme zamanlamasını temsil eder.
SearchError	API için bir hata koşulu açıklar.
SearchIndexer	Dizin oluşturucuları temsil eder.
SearchResourceEncryptionKey	Azure Key Vault'de müşteri tarafından yönetilen bir şifreleme anahtarı. Oluşturduğunuz ve yönettiğiniz anahtarlar, dizinler ve eş anlamlı eşlemeler gibi arama hizmetinizdeki bekleyen verileri şifrelemek veya şifresini çözmek için kullanılabilir.

AzureActiveDirectoryApplicationCredentials

Arama hizmetiniz için oluşturulan ve Azure Key Vault'de depolanan şifreleme anahtarlarına kimliği doğrulanmış erişim için kullanılan kayıtlı bir uygulamanın kimlik bilgileri.

Name	Tür	Description
applicationId	string	Bekleyen verilerinizi şifrelerken kullanılacak Azure Key Vault gerekli erişim izinleri verilmiş bir AAD Uygulama Kimliği. Uygulama Kimliği, AAD Uygulamanızın Nesne Kimliği ile karıştırılmamalıdır.
applicationSecret	string	Belirtilen AAD uygulamasının kimlik doğrulama anahtarı.

BlobIndexerDataToExtract

Azure blob depolamadan ayıklanması gereken verileri belirtir ve "imageAction" "none" dışında bir değere ayarlandığında dizin oluşturucuya görüntü içeriğinden hangi verilerin ayıklandığını bildirir. Bu, azure bloblarındaki .PDF veya başka bir uygulamadaki ekli görüntü içeriği ya da .jpg ve .png gibi görüntü dosyaları için geçerlidir.

Name	Tür	Description
allMetadata	string	Azure blob depolama alt sistemi tarafından sağlanan meta verileri ve içerik türüne özgü meta verileri ayıklar (örneğin, yalnızca .png dosyalara özgü meta veriler dizine alınır).
contentAndMetadata	string	Her blobdan tüm meta verileri ve metin içeriğini ayıklar.
storageMetadata	string	Yalnızca standart blob özelliklerini ve kullanıcı tarafından belirtilen meta verileri dizinler.

BlobIndexerImageAction

Azure blob depolamada ekli görüntülerin ve görüntü dosyalarının nasıl işleneceğini belirler. "imageAction" yapılandırmasını "none" dışında bir değere ayarlamak için bir beceri kümesinin de bu dizin oluşturucuya eklenmesi gerekir.

Name	Tür	Description
generateNormalizedImagePerPage	string	Görüntülerdeki metinleri ayıklar (örneğin, trafik durdurma işaretinden "DURDUR" sözcüğü) ve bunu içerik alanına ekler, ancak pdf dosyalarına her sayfanın resim olarak işlenip ekli görüntüleri ayıklamak yerine uygun şekilde normalleştirileceği şekilde farklı davranır. PDF olmayan dosya türleri, "generateNormalizedImages" ayarlanmış gibi kabul edilir.
generateNormalizedImages	string	Görüntülerdeki metni ayıklar (örneğin, trafik durdurma işaretinden "DURDUR" sözcüğü) ve içerik alanına ekler. Bu eylem için "dataToExtract" öğesinin "contentAndMetadata" olarak ayarlanması gerekir. Normalleştirilmiş görüntü, görsel arama sonuçlarına görüntü eklediğinizde tutarlı işlemeyi yükseltmek için boyutlandırılmış ve döndürülmüş tekdüzen görüntü çıkışına neden olan ek işlemeyi ifade eder. Bu seçenek kullanıldığında her görüntü için bu bilgiler oluşturulur.
none	string	Veri kümesindeki eklenmiş görüntüleri veya görüntü dosyalarını yoksayar. Bu varsayılan seçenektir.

BlobIndexerParsingMode

Azure blob veri kaynağından dizin oluşturma için ayrıştırma modunu temsil eder.

Name	Tür	Description
default	string	Normal dosya işleme için varsayılan olarak ayarlayın.
delimitedText	string	Bloblar düz CSV dosyaları olduğunda delimitedText olarak ayarlayın.
json	string	Yapılandırılmış içeriği JSON dosyalarından ayıklamak için json olarak ayarlayın.
jsonArray	string	JSON dizisinin tek tek öğelerini ayrı belgeler olarak ayıklamak için jsonArray olarak ayarlayın.
jsonLines	string	Ayrı ayrı JSON varlıklarını ayrı belgeler olarak yeni bir satırla ayırarak ayıklamak için jsonLines olarak ayarlayın.
text	string	Blob depolamadaki düz metin dosyalarında dizin oluşturma performansını geliştirmek için metne ayarlayın.

BlobIndexerPDFTextRotationAlgorithm

Azure blob depolamadaki PDF dosyalarından metin ayıklama algoritmasını belirler.

Name	Tür	Description
detectAngles	string	İçinde döndürülmüş metin olan PDF dosyalarından daha iyi ve daha okunabilir metin ayıklaması üretebilir. Bu parametre kullanıldığında küçük bir performans hızı etkisi olabileceğini unutmayın. Bu parametre yalnızca PDF dosyaları için ve yalnızca eklenmiş metin içeren PDF'ler için geçerlidir. Döndürülen metin PDF'deki eklenmiş bir görüntünün içinde görünüyorsa, bu parametre geçerli değildir.
none	string	Normal metin ayıklamadan yararlanıyor. Bu varsayılan seçenektir.

FieldMapping

Veri kaynağındaki bir alan ile dizindeki hedef alan arasında eşleme tanımlar.

Name	Tür	Description
mappingFunction	FieldMappingFunction	Dizin oluşturmadan önce her kaynak alan değerine uygulanacak bir işlev.
sourceFieldName	string	Veri kaynağındaki alanın adı.
targetFieldName	string	Dizindeki hedef alanın adı. Varsayılan olarak kaynak alan adıyla aynıdır.

FieldMappingFunction

Dizin oluşturmadan önce veri kaynağından bir değeri dönüştüren bir işlevi temsil eder.

Name	Tür	Description
name	string	Alan eşleme işlevinin adı.
parameters	object	İşleve geçirilebilir parametre adı/değer çiftleri sözlüğü. Her değer ilkel türde olmalıdır.

IndexerExecutionEnvironment

Dizin oluşturucunun yürütülmesi gereken ortamı belirtir.

Name	Tür	Description
private	string	Dizin oluşturucunun, arama hizmeti için özel olarak sağlanan ortamla birlikte çalışması gerektiğini gösterir. Bu yalnızca dizin oluşturucunun paylaşılan özel bağlantı kaynakları üzerinden kaynaklara güvenli bir şekilde erişmesi gerekiyorsa yürütme ortamı olarak belirtilmelidir.
standard	string	Arama hizmetinin dizin oluşturucunun yürütüleceği yeri belirleyebileceğini gösterir. Bu, hiçbir şey belirtilmediğinde varsayılan ortamdır ve önerilen değerdir.

IndexingParameters

Dizin oluşturucu yürütme parametrelerini temsil eder.

Name	Tür	Varsayılan değer	Description
batchSize	integer		Performansı artırmak için veri kaynağından okunan ve tek bir toplu iş olarak dizine alınan öğelerin sayısı. Varsayılan değer, veri kaynağı türüne bağlıdır.
configuration	IndexingParametersConfiguration		Dizin oluşturucuya özgü yapılandırma özelliklerinin sözlüğü. Her ad, belirli bir özelliğin adıdır. Her değer ilkel türde olmalıdır.
maxFailedItems	integer	0	Dizin oluşturucu yürütmesi için dizin oluşturmada başarısız olabilecek en fazla öğe sayısı yine de başarılı olarak kabul edilir. -1, sınır olmadığı anlamına gelir. Varsayılan değer 0'dır.
maxFailedItemsPerBatch	integer	0	Tek bir toplu işlemdeki, toplu iş için dizin oluşturmada başarısız olabilecek en fazla öğe sayısı yine de başarılı olarak kabul edilir. -1, sınır olmadığı anlamına gelir. Varsayılan değer 0'dır.

IndexingParametersConfiguration

Dizin oluşturucuya özgü yapılandırma özelliklerinin sözlüğü. Her ad, belirli bir özelliğin adıdır. Her değer ilkel türde olmalıdır.

Name	Tür	Varsayılan değer	Description
allowSkillsetToReadFileData	boolean	False	True ise, blob veri kaynağınızdan indirilen özgün dosya verilerini temsil eden bir nesne olan bir //document//file_data yolu oluşturur. Bu, özgün dosya verilerini zenginleştirme işlem hattı içinde işlenmek üzere özel bir beceriye veya Belge Ayıklama becerisine geçirmenizi sağlar.
dataToExtract	BlobIndexerDataToExtract	contentAndMetadata	Azure blob depolamadan ayıklanması gereken verileri belirtir ve "imageAction" "none" dışında bir değere ayarlandığında dizin oluşturucuya görüntü içeriğinden hangi verilerin ayıklandığını bildirir. Bu, azure bloblarındaki .PDF veya başka bir uygulamadaki ekli görüntü içeriği ya da .jpg ve .png gibi görüntü dosyaları için geçerlidir.
delimitedTextDelimiter	string		CSV blobları için, her satırın yeni bir belge başlattığı CSV dosyaları için satır sonu tek karakterli sınırlayıcıyı belirtir (örneğin, "\|").
delimitedTextHeaders	string		CSV blobları için, kaynak alanları dizindeki hedef alanlarla eşlemek için yararlı olan, sütun üst bilgilerinin virgülle ayrılmış bir listesini belirtir.
documentRoot	string		Yapılandırılmış veya yarı yapılandırılmış bir belge verilip JSON dizileri için bu özelliği kullanarak dizinin yolunu belirtebilirsiniz.
excludedFileNameExtensions	string		Azure blob depolamadan işlenirken yoksayılması gereken dosya adı uzantılarının virgülle ayrılmış listesi. Örneğin, dizin oluşturma sırasında bu dosyaları atlamak için ".png, .mp4" hariç tutabilirsiniz.
executionEnvironment	IndexerExecutionEnvironment	standard	Dizin oluşturucunun yürütülmesi gereken ortamı belirtir.
failOnUnprocessableDocument	boolean	False	Azure blobları için, bir belge dizin oluşturmada başarısız olursa dizine eklemeye devam etmek istiyorsanız false olarak ayarlayın.
failOnUnsupportedContentType	boolean	False	Azure blobları için, desteklenmeyen bir içerik türüyle karşılaşıldığında dizine eklemeye devam etmek istiyorsanız ve tüm içerik türlerini (dosya uzantıları) önceden bilmiyorsanız false olarak ayarlayın.
firstLineContainsHeaders	boolean	True	CSV blobları için, her blobun ilk (boş olmayan) satırının üst bilgiler içerdiğini gösterir.
imageAction	BlobIndexerImageAction	none	Azure blob depolamada ekli görüntülerin ve görüntü dosyalarının nasıl işleneceğini belirler. "imageAction" yapılandırmasını "none" dışında bir değere ayarlamak için bir beceri kümesinin de bu dizin oluşturucuya eklenmesi gerekir.
indexStorageMetadataOnlyForOversizedDocuments	boolean	False	Azure blobları için bu özelliği true olarak ayarlayarak işlenmek için çok büyük olan blob içeriğinin depolama meta verilerini dizine almaya devam edin. Büyük büyük bloblar varsayılan olarak hata olarak değerlendirilir. Blob boyutuyla ilgili sınırlar için bkz https://docs.microsoft.com/azure/search/search-limits-quotas-capacity. .
indexedFileNameExtensions	string		Azure blob depolamadan işlenirken seçecek dosya adı uzantılarının virgülle ayrılmış listesi. Örneğin, özellikle bu dosya türlerini dahil etmek için ".docx, .pptx, .msg" belirli uygulama dosyalarında dizin oluşturma konusuna odaklanabilirsiniz.
parsingMode	BlobIndexerParsingMode	default	Azure blob veri kaynağından dizin oluşturma için ayrıştırma modunu temsil eder.
pdfTextRotationAlgorithm	BlobIndexerPDFTextRotationAlgorithm	none	Azure blob depolamadaki PDF dosyalarından metin ayıklama algoritmasını belirler.
queryTimeout	string	00:05:00	"ss:dd:ss" biçiminde belirtilen Azure SQL veritabanı veri kaynakları için zaman aşımını varsayılan 5 dakikadan fazla artırır.

IndexingSchedule

Dizin oluşturucu yürütme zamanlamasını temsil eder.

Name	Tür	Description
interval	string	Dizin oluşturucu yürütmeleri arasındaki zaman aralığı.
startTime	string	Dizin oluşturucunun çalışmaya başlaması gereken zaman.

SearchError

API için bir hata koşulu açıklar.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
details	SearchError[]	Bu bildirilen hataya yol açan belirli hatalarla ilgili ayrıntılar dizisi.
message	string	Hatanın insan tarafından okunabilen bir gösterimi.

SearchIndexer

Dizin oluşturucuları temsil eder.

Name	Tür	Varsayılan değer	Description
@odata.etag	string		Dizin oluşturucunun ETag'i.
dataSourceName	string		Bu dizin oluşturucunun verileri okuduğu veri kaynağının adı.
description	string		Dizin oluşturucunun açıklaması.
disabled	boolean	False	Dizin oluşturucunun devre dışı bırakılıp bırakılmadığını gösteren değer. Varsayılan değer false’tur.
encryptionKey	SearchResourceEncryptionKey		Azure Key Vault'de oluşturduğunuz şifreleme anahtarının açıklaması. Bu anahtar, Microsoft'un bile değil, hiç kimsenin şifresini çözemediğini tam olarak güvenceye almak istediğinizde dizin oluşturucu tanımınız (dizin oluşturucu yürütme durumu) için ek bir bekleyen şifreleme düzeyi sağlamak için kullanılır. Dizin oluşturucu tanımınızı şifreledikten sonra her zaman şifrelenmiş olarak kalır. Arama hizmeti bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek istiyorsanız bu özelliği gerektiği gibi değiştirebilirsiniz; Dizin oluşturucu tanımınız (ve dizin oluşturucu yürütme durumunuz) etkilenmez. Müşteri tarafından yönetilen anahtarlarla şifreleme ücretsiz arama hizmetleri için kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir.
fieldMappings	FieldMapping[]		Veri kaynağındaki alanlarla dizindeki karşılık gelen hedef alanlar arasındaki eşlemeleri tanımlar.
name	string		Dizin oluşturucunun adı.
outputFieldMappings	FieldMapping[]		Çıkış alanı eşlemeleri zenginleştirmeden sonra ve dizin oluşturmadan hemen önce uygulanır.
parameters	IndexingParameters		Dizin oluşturucu yürütme parametreleri.
schedule	IndexingSchedule		Bu dizin oluşturucu için zamanlama.
skillsetName	string		Bu dizin oluşturucuyla yürütülen beceri kümesinin adı.
targetIndexName	string		Bu dizin oluşturucunun veri yazdığı dizinin adı.

SearchResourceEncryptionKey

Azure Key Vault'de müşteri tarafından yönetilen bir şifreleme anahtarı. Oluşturduğunuz ve yönettiğiniz anahtarlar, dizinler ve eş anlamlı eşlemeler gibi arama hizmetinizdeki bekleyen verileri şifrelemek veya şifresini çözmek için kullanılabilir.

Name	Tür	Description
accessCredentials	AzureActiveDirectoryApplicationCredentials	Azure Key Vault erişmek için kullanılan isteğe bağlı Azure Active Directory kimlik bilgileri. Bunun yerine yönetilen kimlik kullanılıyorsa gerekli değildir.
keyVaultKeyName	string	Bekleyen verilerinizi şifrelemek için kullanılacak Azure Key Vault anahtarınızın adı.
keyVaultKeyVersion	string	Bekleyen verilerinizi şifrelemek için kullanılacak Azure Key Vault anahtarınızın sürümü.
keyVaultUri	string	Bekleyen verilerinizi şifrelemek için kullanılacak anahtarı içeren, DNS adı olarak da adlandırılan Azure Key Vault URI'niz. Örnek bir URI olabilir `https://my-keyvault-name.vault.azure.net`.

Share via