Tjänstadministration för Azure AI Search i Azure-portalen
I Azure AI Search stöder Azure-portalen ett brett utbud av administrativa åtgärder och innehållshanteringsåtgärder så att du inte behöver skriva kod om du inte vill ha automatisering.
Varje söktjänst hanteras som en fristående resurs. Rolltilldelningen avgör vilka åtgärder som exponeras i portalen.
Portal- och administratörsbehörigheter
Portalåtkomst sker via rolltilldelningar. Som standard börjar alla söktjänster med minst en ägare. Ägare, tjänstadministratörer och medadministratörer har behörighet att skapa andra administratörer och andra rolltilldelningar. De har fullständig åtkomst till alla portalsidor och åtgärder.
Deltagare och search service-deltagare har samma åtkomst som Ägare, minus möjligheten att tilldela roller.
Läsare har åtkomst till tjänstinformation i avsnittet Essentials och på fliken Övervakning. Åtkomsten är begränsad. En läsare kan få grundläggande information om en söktjänst, men inte tillräckligt för att konfigurera en anslutning eller bekräfta förekomsten av objekt i tjänsten.
För dataplansuppgifter, till exempel att skapa och konfigurera index och indexerare: i ett standardsystem försöker portalen först använda administratörs-API-nycklar, även om det finns rolltilldelningar. Om nycklar är inaktiverade är det här portalupplevelsen för följande roller:
Search Index Data Contributor kan se listan över indexerare och komma åt en enskild för att se dess historiska körningar och status, men kan inte köra, återställa, skapa, uppdatera eller ta bort den.
En dataläsare för sökindex kan köra frågor mot indexen.
Om du vill ha obegränsad åtkomst till portalfunktioner, inklusive möjligheten att köra guiden Importera data, bör du ha behörighet som deltagare eller Search Servicer-deltagare.
Dricks
Som standard kan alla ägare eller administratörer skapa eller ta bort tjänster. Om du vill förhindra oavsiktliga borttagningar kan du låsa resurser.
Snabb överblick över Azure-portalen
Översiktssidan är startsidan för varje tjänst. I följande skärmbild visar de röda rutorna uppgifter, verktyg och paneler som du kan använda ofta, särskilt om du är nybörjare på tjänsten.
| Område | beskrivning |
|---|---|
| 1 | Ett kommandofält överst på sidan innehåller guiden Importera data och Sökutforskaren, som används för prototyper och utforskning. |
| 2 | Avsnittet Essentials listar tjänstegenskaper, till exempel tjänstslutpunkt, tjänstnivå och antal repliker och partitioner. |
| 3 | Sidor med flikar i mitten ger snabb åtkomst till användningsstatistik och hälsomått för tjänster. |
| 4 | Navigeringslänkar till befintliga index, indexerare, datakällor och kompetensuppsättningar. |
Du kan inte ändra söktjänstens namn, prenumeration, resursgrupp, region (plats) eller nivå. Om du byter nivå måste du skapa en ny tjänst eller skicka in ett supportärende för att begära en nivåuppgradering, som endast stöds för Basic och senare.
Checklista för hantering dag ett
I en ny söktjänst rekommenderar vi dessa konfigurationsuppgifter.
Kontrollera kapacitet och förstå fakturering
Som standard skapas en söktjänst i en minsta konfiguration av en replik och partition vardera. Du kan lägga till kapacitet genom att lägga till repliker och partitioner, men vi rekommenderar att du väntar tills volymerna kräver det. Många kunder kör produktionsarbetsbelastningar med minsta möjliga konfiguration.
Vissa funktioner ökar kostnaden för att köra tjänsten:
- Hur du debiteras för Azure AI Search förklarar vilka funktioner som påverkar faktureringen.
- (Valfritt) inaktivera semantisk rangordning på tjänstnivå för att förhindra användning av funktionen.
Konfigurera nätverkssäkerhet
Som standard accepterar en söktjänst autentiserade och auktoriserade begäranden via offentliga Internetanslutningar. Nätverkssäkerhet begränsar åtkomsten via brandväggsregler eller genom att inaktivera offentliga anslutningar och endast tillåta begäranden från virtuella Azure-nätverk.
- Konfigurera IP-brandväggsregler för att begränsa åtkomsten med IP-adress.
- Konfigurera en privat slutpunkt med Azure Private Link och ett privat virtuellt nätverk.
Säkerhet i Azure AI Search förklarar inkommande och utgående anrop i Azure AI Search.
Aktivera diagnostikloggning
Aktivera diagnostikloggning för att spåra användaraktivitet. Om du hoppar över det här steget får du fortfarande aktivitetsloggar och plattformsmått automatiskt, men om du vill ha information om index- och frågeanvändning bör du aktivera diagnostikloggning och välja ett mål för loggade åtgärder.
Vi rekommenderar Log Analytics-arbetsytan för varaktig lagring så att du kan köra systemfrågor i portalen.
Internt samlar Microsoft in telemetridata om din tjänst och plattformen. Den lagras internt i Microsofts datacenter och görs globalt tillgänglig för Microsofts supporttekniker när du öppnar ett supportärende.
| Övervaka data | Kvarhållning |
|---|---|
| Aktivitetsloggar | 90 dagar enligt ett löpande schema |
| Plattformsmått | 93 dagar enligt ett löpande schema, förutom att portalvisualiseringen är begränsad till ett 30-dagarsfönster |
| Resursloggar | Användarhanterad |
| Telemetri | Ett och ett halvt år |
Kommentar
Mer information om dataplats och sekretess finns i avsnittet "Datahemvist" i säkerhetsöversikten.
Konfigurera användaråtkomst
Till en början har endast en ägare åtkomst till söktjänstinformation och -åtgärder. Tilldela roller för att utöka åtkomsten eller ge användarna en sökslutpunkt med en API-nyckel.
En söktjänst skapas alltid med API-nycklar. En administratörs-API-nyckel ger läs- och skrivåtkomst till alla dataplansåtgärder. Du kan inte ta bort administratörs-API-nycklar, men du kan inaktivera API-nycklar om du vill att alla användare ska få åtkomst till dataplansåtgärder via rolltilldelningar.
Ange anslutningsinformation till utvecklare
Utvecklare behöver följande information för att ansluta till Azure AI Search:
- En slutpunkt eller URL som finns på sidan Översikt .
- En API-nyckel från sidan Nycklar eller en rolltilldelning (deltagare rekommenderas).
Vi rekommenderar portalåtkomst för följande guider och verktyg: Guiden Importera data, Importera och vektorisera data, Sökutforskaren. Kom ihåg att en användare måste vara deltagare eller senare för att kunna köra importguiderna.
Nästa steg
Programmatiskt stöd för tjänstadministration finns i följande API:er och moduler:
Du kan också använda hanteringsklientbiblioteken i Azure SDK:er för .NET, Python, Java och JavaScript.
Det finns funktionsparitet för alla modaliteter och språk, förutom funktioner för förhandsversionshantering. Som en allmän regel släpps förhandsversionshanteringsfunktionerna först via REST API för hantering.