SearchIndexClient Klass
En klient för att interagera med Azure Search-tjänstindex.
- Arv
-
azure.search.documents._headers_mixin.HeadersMixinSearchIndexClient
Konstruktor
SearchIndexClient(endpoint: str, credential: AzureKeyCredential | TokenCredential, **kwargs: Any)
Parametrar
- credential
- AzureKeyCredential eller TokenCredential
En autentiseringsuppgift för att auktorisera sökklientbegäranden
- api_version
- str
Den Search API-version som ska användas för begäranden.
- audience
- str
anger vilken målgrupp som ska användas för autentisering med Azure Active Directory (AAD). Målgruppen beaktas inte när du använder en delad nyckel. Om målgruppen inte tillhandahålls antas målgruppen för det offentliga molnet.
Metoder
analyze_text |
Visar hur ett analysverktyg delar upp text i token. |
close |
SearchIndexClient Stäng sessionen. |
create_index |
Skapar ett nytt sökindex. |
create_or_update_index |
Skapar ett nytt sökindex eller uppdaterar ett index om det redan finns. |
create_or_update_synonym_map |
Skapa en ny synonymkarta i en Azure-tjänsten Search eller uppdatera en befintlig mappning. |
create_synonym_map |
Skapa en ny synonymkarta i en Azure-tjänsten Search |
delete_index |
Tar bort ett sökindex och alla dokument som det innehåller. Modellen måste anges i stället för namnet för att åtkomstvillkoren ska kunna användas. |
delete_synonym_map |
Ta bort en namngiven synonymkarta i en Azure-tjänsten Search. Om du vill använda åtkomstvillkor måste SynonymMap-modellen anges i stället för namnet. Det räcker att ange namnet på synonymkartan för att ta bort villkorslöst. |
get_index | |
get_index_statistics |
Returnerar statistik för det angivna indexet, inklusive ett antal dokument och lagringsanvändning. |
get_search_client |
Returnera en klient för att utföra åtgärder vid sökning |
get_service_statistics |
Hämta statistik på tjänstnivå för en söktjänst. |
get_synonym_map |
Hämta en namngiven synonymkarta i en Azure-tjänsten Search |
get_synonym_map_names |
Visa en lista över synonymmappningsnamn i en Azure-tjänsten Search. |
get_synonym_maps |
Visa en lista över synonymkartor i en Azure-tjänsten Search. |
list_index_names |
Lista indexnamnen i en Azure-tjänsten Search. |
list_indexes |
Lista indexen i en Azure-tjänsten Search. |
analyze_text
Visar hur ett analysverktyg delar upp text i token.
analyze_text(index_name: str, analyze_request: AnalyzeTextOptions, **kwargs: Any) -> AnalyzeResult
Parametrar
Returer
AnalyzeResult
Returtyp
Undantag
Exempel
Analysera text
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient
from azure.search.documents.indexes.models import AnalyzeTextOptions
client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))
analyze_request = AnalyzeTextOptions(text="One's <two/>", analyzer_name="standard.lucene")
result = client.analyze_text(index_name, analyze_request)
print(result.as_dict())
close
create_index
Skapar ett nytt sökindex.
create_index(index: SearchIndex, **kwargs: Any) -> SearchIndex
Parametrar
Returer
Indexet som skapats
Returtyp
Undantag
Exempel
Skapa ett nytt index.
client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))
name = "hotels"
fields = [
SimpleField(name="hotelId", type=SearchFieldDataType.String, key=True),
SimpleField(name="baseRate", type=SearchFieldDataType.Double),
SearchableField(name="description", type=SearchFieldDataType.String, collection=True),
ComplexField(
name="address",
fields=[
SimpleField(name="streetAddress", type=SearchFieldDataType.String),
SimpleField(name="city", type=SearchFieldDataType.String),
],
collection=True,
),
]
cors_options = CorsOptions(allowed_origins=["*"], max_age_in_seconds=60)
scoring_profiles: List[ScoringProfile] = []
index = SearchIndex(name=name, fields=fields, scoring_profiles=scoring_profiles, cors_options=cors_options)
result = client.create_index(index)
create_or_update_index
Skapar ett nytt sökindex eller uppdaterar ett index om det redan finns.
create_or_update_index(index: SearchIndex, allow_index_downtime: bool | None = None, *, match_condition: MatchConditions = MatchConditions.Unconditionally, **kwargs: Any) -> SearchIndex
Parametrar
- allow_index_downtime
- bool
Gör att nya analysverktyg, tokeniserare, tokenfilter eller teckenfilter kan läggas till i ett index genom att indexet kopplas från i minst några sekunder. Detta gör tillfälligt att indexering och frågebegäranden misslyckas. Indexets prestanda- och skrivtillgänglighet kan försämras i flera minuter efter att indexet har uppdaterats eller längre för mycket stora index.
- match_condition
- MatchConditions
Matchningsvillkoret som ska användas på etag
Returer
Indexet som skapats eller uppdaterats
Returtyp
Undantag
Exempel
Uppdatera ett index.
client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))
name = "hotels"
fields = [
SimpleField(name="hotelId", type=SearchFieldDataType.String, key=True),
SimpleField(name="baseRate", type=SearchFieldDataType.Double),
SearchableField(name="description", type=SearchFieldDataType.String, collection=True),
SearchableField(name="hotelName", type=SearchFieldDataType.String),
ComplexField(
name="address",
fields=[
SimpleField(name="streetAddress", type=SearchFieldDataType.String),
SimpleField(name="city", type=SearchFieldDataType.String),
SimpleField(name="state", type=SearchFieldDataType.String),
],
collection=True,
),
]
cors_options = CorsOptions(allowed_origins=["*"], max_age_in_seconds=60)
scoring_profile = ScoringProfile(name="MyProfile")
scoring_profiles = []
scoring_profiles.append(scoring_profile)
index = SearchIndex(name=name, fields=fields, scoring_profiles=scoring_profiles, cors_options=cors_options)
result = client.create_or_update_index(index=index)
create_or_update_synonym_map
Skapa en ny synonymkarta i en Azure-tjänsten Search eller uppdatera en befintlig mappning.
create_or_update_synonym_map(synonym_map: SynonymMap, *, match_condition: MatchConditions = MatchConditions.Unconditionally, **kwargs: Any) -> SynonymMap
Parametrar
- match_condition
- MatchConditions
Matchningsvillkoret som ska användas på etag
Returer
Den skapade eller uppdaterade synonymmappningen
Returtyp
Undantag
create_synonym_map
Skapa en ny synonymkarta i en Azure-tjänsten Search
create_synonym_map(synonym_map: SynonymMap, **kwargs: Any) -> SynonymMap
Parametrar
Returer
Den skapade synonymkartan
Returtyp
Undantag
Exempel
Skapa en synonymkarta
synonyms = [
"USA, United States, United States of America",
"Washington, Wash. => WA",
]
synonym_map = SynonymMap(name="test-syn-map", synonyms=synonyms)
result = client.create_synonym_map(synonym_map)
print("Create new Synonym Map 'test-syn-map succeeded")
delete_index
Tar bort ett sökindex och alla dokument som det innehåller. Modellen måste anges i stället för namnet för att åtkomstvillkoren ska kunna användas.
delete_index(index: str | SearchIndex, *, match_condition: MatchConditions = MatchConditions.Unconditionally, **kwargs: Any) -> None
Parametrar
- match_condition
- MatchConditions
Matchningsvillkoret som ska användas på etag
Undantag
Exempel
Ta bort ett index.
client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))
name = "hotels"
client.delete_index(name)
delete_synonym_map
Ta bort en namngiven synonymkarta i en Azure-tjänsten Search. Om du vill använda åtkomstvillkor måste SynonymMap-modellen anges i stället för namnet. Det räcker att ange namnet på synonymkartan för att ta bort villkorslöst.
delete_synonym_map(synonym_map: str | SynonymMap, *, match_condition: MatchConditions = MatchConditions.Unconditionally, **kwargs: Any) -> None
Parametrar
- match_condition
- MatchConditions
Matchningsvillkoret som ska användas på etag
Returer
Ingen
Returtyp
Undantag
Exempel
Ta bort en synonymmappning
client.delete_synonym_map("test-syn-map")
print("Synonym Map 'test-syn-map' deleted")
get_index
get_index(name: str, **kwargs: Any) -> SearchIndex
Parametrar
Returer
SearchIndex-objekt
Returtyp
Undantag
Exempel
Hämta ett index.
client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))
name = "hotels"
result = client.get_index(name)
get_index_statistics
Returnerar statistik för det angivna indexet, inklusive ett antal dokument och lagringsanvändning.
get_index_statistics(index_name: str, **kwargs: Any) -> MutableMapping[str, Any]
Parametrar
Returer
Statistik för det angivna indexet, inklusive ett antal dokument och lagringsanvändning.
Returtyp
Undantag
get_search_client
Returnera en klient för att utföra åtgärder vid sökning
get_search_client(index_name: str, **kwargs: Any) -> SearchClient
Parametrar
Returer
SearchClient-objekt
Returtyp
Undantag
get_service_statistics
Hämta statistik på tjänstnivå för en söktjänst.
get_service_statistics(**kwargs: Any) -> MutableMapping[str, Any]
Returer
Resultat av tjänststatistik.
Returtyp
Undantag
get_synonym_map
Hämta en namngiven synonymkarta i en Azure-tjänsten Search
get_synonym_map(name: str, **kwargs: Any) -> SynonymMap
Parametrar
Returer
Den hämtade synonymkartan
Returtyp
Undantag
Exempel
Hämta en synonymkarta
result = client.get_synonym_map("test-syn-map")
print("Retrived Synonym Map 'test-syn-map' with synonyms")
for syn in result.synonyms:
print(" {}".format(syn))
get_synonym_map_names
Visa en lista över synonymmappningsnamn i en Azure-tjänsten Search.
get_synonym_map_names(**kwargs: Any) -> List[str]
Returer
Lista över synonymmappningar
Returtyp
Undantag
get_synonym_maps
Visa en lista över synonymkartor i en Azure-tjänsten Search.
get_synonym_maps(*, select: List[str] | None = None, **kwargs) -> List[SynonymMap]
Parametrar
Väljer vilka egenskaper på den översta nivån för de kompetensuppsättningar som ska hämtas. Anges som en lista över JSON-egenskapsnamn eller *för alla egenskaper. Standardvärdet är alla egenskaper.
Returer
Lista över synonymmappningar
Returtyp
Undantag
Exempel
Lista synonymkartor
result = client.get_synonym_maps()
names = [x.name for x in result]
print("Found {} Synonym Maps in the service: {}".format(len(result), ", ".join(names)))
list_index_names
Lista indexnamnen i en Azure-tjänsten Search.
list_index_names(**kwargs: Any) -> ItemPaged[str]
Returer
Lista över indexnamn
Returtyp
Undantag
list_indexes
Lista indexen i en Azure-tjänsten Search.
list_indexes(*, select: List[str] | None = None, **kwargs: Any) -> ItemPaged[SearchIndex]
Parametrar
Väljer vilka egenskaper på den översta nivån för de kompetensuppsättningar som ska hämtas. Anges som en lista över JSON-egenskapsnamn eller *för alla egenskaper. Standardvärdet är alla egenskaper.
Returer
Lista över index
Returtyp
Undantag
Azure SDK for Python