- Added back
semantic_queryforSearchmethod. - Added back alias operations to
SearchIndexClient. - Added back
AzureOpenAIEmbeddingSkill,AzureOpenAIParametersandAzureOpenAIVectorizer. - Added back
query_language,query_speller,semantic_fieldsanddebugforSearchmethod. - Added
send_requestmethod forSearchClient&SearchIndexClientto run a network request using the client's existing pipeline.
- Fixed the issue that we added unexpected
retrievableproperty forSearchField.
- Python 3.7 is no longer supported. Please use Python version 3.8 or later.
- Added new models:
VectorSearchAlgorithmMetricIndexProjectionModeSearchIndexerIndexProjectionsSearchIndexerIndexProjectionSelectorSearchIndexerIndexProjectionsParametersBlobIndexerDataToExtractBlobIndexerImageActionBlobIndexerParsingModeCharFilterNameCustomEntityCustomEntityAliasDataChangeDetectionPolicyDataDeletionDetectionPolicyDefaultCognitiveServicesAccountHighWaterMarkChangeDetectionPolicyHnswAlgorithmConfigurationIndexerExecutionResultIndexingParametersIndexingParametersConfigurationIndexingScheduleLexicalAnalyzerNameLexicalTokenizerNamePIIDetectionSkillPIIDetectionSkillMaskingModeScoringProfileSemanticSearch
- Added
index_projectionssupport forSearchIndexerSkillset
These changes do not impact the API of stable versions such as 11.3.0. Only code written against a beta version such as 11.4.0b11 may be affected.
- Renamed
AnswerResulttoQueryAnswerResultandCaptionResulttoQueryCaptionResult. - Renamed
SemanticErrorHandlingtoSemanticErrorMode. - Renamed
RawVectorQuerytoVectorizedQuery. - Renamed
ExhaustiveKnnVectorSearchAlgorithmConfigurationtoExhaustiveKnnAlgorithmConfiguration. - Renamed
PrioritizedFieldstoSemanticPrioritizedFields. - Renamed
query_caption_highlighttoquery_caption_highlight_enabled. query_languageandquery_spellerare not available forSearchmethod in this stable release.aliasoperations are not available in this stable release.AzureOpenAIEmbeddingSkill,AzureOpenAIParametersandAzureOpenAIVectorizerare not available in 11.4.0.- Renamed
vector_search_profiletovector_search_profile_nameinSearchField.
- Used API version "2023-11-01".
- Added
vector_filter_modesupport forSearchmethod. - Exposed
VectorizableTextQueryinazure.search.document.models.
These changes do not impact the API of stable versions such as 11.3.0. Only code written against a beta version such as 11.4.0b6 may be affected.
- Renamed
vector_search_configurationtovector_search_profileinSearchField. - Renamed
vectorstovector_queriesinSearchmethod. - Renamed
azure.search.documents.models.Vectortoazure.search.documents.models.VectorQuery. - Stopped supporting api version
V2023_07_01_PREVIEWanymore.
- Default to use API version
V2023_10_01_PREVIEW
- Fixed the bug that list type of
order_bywas not correctly handled. #31837
- Exposed
HnswVectorSearchAlgorithmConfiguration
These changes do not impact the API of stable versions such as 11.3.0. Only code written against a beta version such as 11.4.0b6 may be affected.
- Instead of using
VectorSearchAlgorithmConfiguration, now you need to use concrete types likeHnswVectorSearchAlgorithmConfiguration.
- Added multi-vector search support. Now instead of passing in
vector,top_kandvector_fields, search method acceptsvectorswhich is a list ofVectorobject.
These changes do not impact the API of stable versions such as 11.3.0. Only code written against a beta version such as 11.4.0b6 may be affected.
- Stopped supporting
vector,top_kandvector_fieldsinSearchClient.searchmethod.
- Added
top_ksupport forVectorSearch.
- Exposed
azure.search.documents.models.Vector.
- Added
VectorSearchsupport.
- Deprecated
SentimentSkillV1andEntityRecognitionSkillV1.
- Added the semantic reranker score and captions on
SearchResult.(thanks to @LucasVascovici for the contribution)
- Enabled
OcrSkillandImageAnalysisSkill
- Added Python 3.11 support.
- Added support to create, update and delete aliases via the
SearchIndexClient.
- Some of the features that were available in the
11.3.0b8version are not available in this GA. They would be available in the upcoming beta release.
- Added support for other national clouds.
- Added support for TokenCredential
- Fixed issue where async
searchcall would fail with a 403 error when retrieving large number of documents.
- Python 3.6 is no longer supported. Please use Python version 3.7 or later.
- Fixes a bug allowing users to set keys for cognitive service skills using the API. Exposes
DefaultCognitiveServicesAccountandCognitiveServicesAccountKey
- Added support to create, update and delete aliases via the
SearchIndexClient.
- Support for
AzureMachineLearningSkill. The AML skill allows you to extend AI enrichment with a custom Azure Machine Learning (AML) model. Once an AML model is trained and deployed, an AML skill integrates it into AI enrichment.
- Python 2.7 is no longer supported. Please use Python version 3.6 or later.
Minor updates.
- Added properties to
SearchClient.search:semantic_configuration_name - Added properties to
SearchIndex:semantic_settings - Added models:
PrioritizedFields,SemanticConfiguration,SemanticField,SemanticSettings - Added new values to model
QueryLanguage
- Added properties to
SearchClient.search:session_id,scoring_statistics. - Added properties to
SearchIndexerDataSourceConnection:identity,encryption_key. - Added
selectproperty to the followingSearchIndexClientoperations:get_synonym_maps,list_indexes. - Added
selectproperty to the followingSearchIndexersClientoperations:get_data_source_connections,get_indexers,get_skillsets. - Added operations to
SearchIndexerClient:reset_skills,reset_documents. - Added model:
DocumentKeysOrIds
- Added properties to
SearchClient:query_answer,query_answer_count,query_caption,query_caption_highlightandsemantic_fields.
- Renamed
SearchClient.spellertoSearchClient.query_speller. - Renamed model
SpellertoQuerySpellerType. - Renamed model
AnswerstoQueryAnswerType. - Removed keyword arguments from
SearchClient:answersandcaptions. SentimentSkill,EntityRecognitionSkill: added client-side validation to prevent sending unsupported parameters.- Renamed property
ignore_reset_requirementstoskip_indexer_reset_requirement_for_cache.
- Added new models:
azure.search.documents.models.QueryCaptionTypeazure.search.documents.models.CaptionResultazure.search.documents.indexes.models.CustomEntityLookupSkillLanguageazure.search.documents.indexes.models.EntityRecognitionSkillVersionazure.search.documents.indexes.models.LexicalNormalizerNameazure.search.documents.indexes.models.PIIDetectionSkillazure.search.documents.indexes.models.PIIDetectionSkillMaskingModeazure.search.documents.indexes.models.SearchIndexerCacheazure.search.documents.indexes.models.SearchIndexerDataIdentityazure.search.documents.indexes.models.SearchIndexerDataNoneIdentityazure.search.documents.indexes.models.SearchIndexerDataUserAssignedIdentityazure.search.documents.indexes.models.SentimentSkillVersion
- Added
normalizer_nameproperty toAnalyzeTextOptionsmodel.
- Removed:
azure.search.documents.indexes.models.SentimentSkillV3azure.search.documents.indexes.models.EntityRecognitionSkillV3
- Renamed:
SearchField.normalizerrenamed toSearchField.normalizer_name.
SentimentSkillandEntityRecognitionSkillcan now be created by specifying theskill_versionkeyword argument with aSentimentSkillVersionorEntityRecognitionSkillVersion, respectively. The default behavior ifskill_versionis not specified is to create a version 1 skill.
- Added new skills:
SentimentSkillV3,EntityLinkingSkill,EntityRecognitionSkillV3
- Added AAD support
- Added support for semantic search
- Added normalizer support
This version will be the last version to officially support Python 3.5, future versions will require Python 2.7 or Python 3.6+.
New features
- Added support for knowledge store #18461
- Added new data source type ADLS gen2 #16852
Breaking Changes
IndexDocumentsBatchdoes not supportenqueue_actionany longer.enqueue_actionstakes a single action too.max_retriesofSearchIndexingBufferedSenderis renamed tomax_retries_per_actionSearchClientdoes not supportget_search_indexing_buffered_sender
Features
- Added
get_search_indexing_buffered_sendersupport forSearchClient - Added
initial_batch_action_countsupport forSearchIndexingBufferedSender - Added
max_retriessupport forSearchIndexingBufferedSender
Breaking Changes
- Renamed
SearchIndexDocumentBatchingClienttoSearchIndexingBufferedSender - Renamed
SearchIndexDocumentBatchingClient.add_upload_actionstoSearchIndexingBufferedSender.upload_documents - Renamed
SearchIndexDocumentBatchingClient.add_delete_actionstoSearchIndexingBufferedSender.delete_documents - Renamed
SearchIndexDocumentBatchingClient.add_merge_actionstoSearchIndexingBufferedSender.merge_documents - Renamed
SearchIndexDocumentBatchingClient.add_merge_or_upload_actionstoSearchIndexingBufferedSender.merge_or_upload_documents - Stopped supporting
windowkwargs forSearchIndexingBufferedSender - Splitted kwarg
hookintoon_new,on_progress,on_error,on_removeforSearchIndexingBufferedSender
Features
- Added
auto_flush_intervalsupport forSearchIndexingBufferedSender
Features
- Added
azure.search.documents.RequestEntityTooLargeError Flushmethod inBatchClientnow will not return until all actions are done
Breaking Changes
- Removed
succeeded_actions&failed_actionsfromBatchClient - Removed
get_index_document_batching_clientfromSearchClient
Features
- new
SearchIndexDocumentBatchingClient
SearchIndexDocumentBatchingClient supports handling document indexing actions in an automatic way. It can trigger the flush method automatically based on pending tasks and idle time.
- Doc & Sample fixes
Features
-
Exposed more models:
- BM25SimilarityAlgorithm
- ClassicSimilarityAlgorithm
- EdgeNGramTokenFilterSide
- EntityCategory
- EntityRecognitionSkillLanguage
- FieldMapping
- FieldMappingFunction
- ImageAnalysisSkillLanguage
- ImageDetail
- IndexerExecutionStatus
- IndexerStatus
- KeyPhraseExtractionSkillLanguage
- MicrosoftStemmingTokenizerLanguage
- MicrosoftTokenizerLanguage
- OcrSkillLanguage
- PhoneticEncoder
- ScoringFunctionAggregation
- ScoringFunctionInterpolation
Breaking Changes
-
Reorganized
SearchServiceClientintoSearchIndexClient&SearchIndexerClient#11507 -
Split searchindex.json and searchservice.json models and operations into separate namespaces #11508
-
Renamed
edmtoSearchFieldDataType#11511 -
Now Search Synonym Map creation/update returns a model #11514
-
Renaming #11565
- SearchIndexerDataSource -> SearchIndexerDataSourceConnection
- SearchField.SynonymMaps -> SearchField.SynonymMapNames
- SearchField.Analyzer -> SearchField.AnalyzerName
- SearchField.IndexAnalyzer -> SearchField.IndexAnalyzerName
- SearchField.SearchAnalyzer -> SearchField.SearchAnalyzerName
- SearchableField.SynonymMaps -> SearchableField.SynonymMapNames
- SearchableField.Analyzer -> SearchableField.AnalyzerName
- SearchableField.IndexAnalyzer -> SearchableField.IndexAnalyzerName
- SearchableField.SearchAnalyzer -> SearchableField.SearchAnalyzerName
- Similarity -> SimilarityAlgorithm
- Suggester -> SearchSuggester
- PathHierarchyTokenizerV2 -> PathHierarchyTokenizer
-
Renamed DataSource methods to DataSourceConnection #11693
-
Autocomplete & suggest methods now takes arguments search_text & suggester_name rather than query objects #11747
-
Create_or_updates methods does not support partial updates #11800
-
Renamed AnalyzeRequest to AnalyzeTextOptions #11800
-
Renamed Batch methods #11800
Features
- Add support for synonym maps operations #10830
- Add support for skillset operations #10832
- Add support of indexers operation #10836
- Add helpers for defining searchindex fields #10833
Breaking Changes
SearchIndexClientrenamed toSearchClient
Features
- Added index service client #10324
- Accepted an array of RegexFlags for PatternAnalyzer and PatternTokenizer #10409
Breaking Changes
- Removed
SearchApiKeyCredentialand now usingAzureKeyCredentialfrom azure.core.credentials as key credential
First release of Azure Search SDK for Python