Funkcje

Usługa Azure API for FHIR zapewnia w pełni zarządzane wdrożenie serwera Microsoft FHIR dla platformy Azure. Serwer jest implementacją standardu FHIR . Ten dokument zawiera listę głównych funkcji serwera FHIR.

Wersja FHIR

Obsługiwana najnowsza wersja: 4.0.1

Poprzednie wersje są również obecnie obsługiwane: 3.0.2

Interfejs API REST

Poniżej przedstawiono podsumowanie obsługiwanych funkcji RESTful. Aby uzyskać więcej informacji na temat implementacji tych funkcji, zobacz FHIR REST API capabilities (Możliwości interfejsu API REST FHIR).

interfejs API	Interfejs API platformy Azure dla standardu FHIR	Usługa FHIR w Azure Health Data Services	Komentarz
odczyt	Tak	Tak
vread	Tak	Tak
update	Tak	Tak
aktualizacja z optymistycznym blokowaniem	Tak	Tak
aktualizacja (warunkowa)	Tak	Tak
Patch	Tak	Tak	Obsługa tylko poprawek JSON i poprawki FHIRPath.
patch (warunkowe)	Tak	Tak	Obsługa tylko poprawek JSON i poprawki FHIRPath.
Historia	Tak	Tak
create	Tak	Tak	Obsługa funkcji POST/PUT
tworzenie (warunkowe)	Tak	Tak	Problem nr 1382
search	Częściowe	Częściowe	Zobacz Omówienie wyszukiwania FHIR.
wyszukiwanie łańcuchowe	Tak	Tak	Zobacz uwagę poniżej.
wyszukiwanie odwrotne łańcuchowe	Tak	Tak	Zobacz uwagę poniżej.
batch	Tak	Tak
Transakcji	Nie.	Tak
Stronicowania	Częściowe	Częściowe	self i next są obsługiwane
Pośredników	Nie	Nr

Uwaga

W usłudze Azure API for FHIR i serwerze open source FHIR wspieranym przez usługę Azure Cosmos DB łańcuchowe wyszukiwanie i wyszukiwanie odwrotne jest implementacją MVP. Aby wykonać wyszukiwanie łańcuchowe w usłudze Azure Cosmos DB, implementacja przechodzi w dół wyrażenia wyszukiwania i problemów podrzędnych w celu rozwiązania dopasowanych zasobów. Odbywa się to dla każdego poziomu wyrażenia. Jeśli jakiekolwiek zapytanie zwróci więcej niż 1000 wyników, zostanie zgłoszony błąd.

Operacje rozszerzone

Wszystkie obsługiwane operacje rozszerzające interfejs API REST.

Typ parametru wyszukiwania	Interfejs API platformy Azure dla standardu FHIR	Usługa FHIR w Azure Health Data Services	Komentarz
$export	Tak	Tak	Obsługuje system, grupę i pacjenta.
$convert danych	Tak	Tak
$validate	Tak	Tak
$member dopasowanie	Tak	Tak
$patient wszystko	Tak	Tak
historia $purge	Tak	Tak

Trwałość

Serwer Microsoft FHIR ma podłączony moduł trwałości (zobacz Microsoft.Health.Fhir.Core.Features.Persistence).

Obecnie kod open source serwera FHIR zawiera implementację usług Azure Cosmos DB i SQL Database.

Azure Cosmos DB to globalnie rozproszona wielomodelowa baza danych (NoSQL, MongoDB i inne). Obsługuje różne poziomy spójności. Domyślny szablon wdrożenia konfiguruje serwer FHIR ze spójnością Strong , ale zasady spójności można modyfikować (ogólnie złagodzone) na żądanie przy użyciu nagłówka x-ms-consistency-level żądania.

Kontrola dostępu oparta na rolach

Serwer FHIR używa identyfikatora Microsoft Entra ID do kontroli dostępu. W szczególności wymuszana jest kontrola dostępu oparta na rolach (RBAC), jeśli FhirServer:Security:Enabled parametr konfiguracji jest ustawiony na true, a wszystkie żądania (z wyjątkiem /metadata) serwera FHIR muszą mieć Authorization nagłówek żądania ustawiony na Bearer <TOKEN>wartość . Token musi zawierać co najmniej jedną rolę zdefiniowaną w oświadczeniu roles . Żądanie będzie dozwolone, jeśli token zawiera rolę, która zezwala na określoną akcję dla określonego zasobu.

Obecnie dozwolone akcje dla danej roli są stosowane globalnie w interfejsie API.

Limity usługi

• Jednostki żądań (RU) — w portalu dla usługi Azure API for FHIR można skonfigurować maksymalnie 100 000 jednostek RU. Będziesz potrzebować co najmniej 400 jednostek RU lub 40 jednostek RU/GB, w zależności od tego, co jest większe. Jeśli potrzebujesz więcej niż 100 000 jednostek RU, możesz umieścić bilet pomocy technicznej, aby zwiększyć liczbę jednostek RU. Maksymalna dostępna wartość to 1000 000. Ponadto obsługujemy skalowanie automatyczne jednostek RU.

• Rozmiar pakietu — każdy pakiet jest ograniczony do 500 elementów.

• Rozmiar danych — dane/dokumenty muszą być nieco mniejsze niż 2 MB.

• Limit subskrypcji — domyślnie każda subskrypcja jest ograniczona do maksymalnie 10 wystąpień serwera FHIR. Jeśli potrzebujesz więcej wystąpień na subskrypcję, otwórz bilet pomocy technicznej i podaj szczegółowe informacje o swoich potrzebach.

• Rozmiar zasobu — rozmiar zasobu indywidualnego, w tym historia, nie powinien przekraczać 20 GB.

Następne kroki

W tym artykule omówiono obsługiwane funkcje FHIR w usłudze Azure API for FHIR. Aby uzyskać informacje o wdrażaniu usługi Azure API for FHIR, zobacz

Wdrażanie interfejsu AZURE API for FHIR

FHIR® jest zastrzeżonym znakiem towarowym HL7 i jest używany z uprawnieniem HL7.