이 페이지에서는 Health Level Seven Version 2.x(HL7v2) 저장소를 만들고, 편집, 확인, 삭제하는 방법을 설명합니다. HL7v2 저장소에는 시스템 간에 임상 데이터를 전송하는 데 사용되는 HL7v2 메시지가 보관됩니다.
HL7v2 저장소 만들기
HL7v2 저장소를 만들려면 먼저 데이터 세트를 만들어야 합니다.
HL7v2 저장소를 만들 때 V3
파서 버전을 지정합니다. HL7v2 저장소를 만든 후에는 파서 버전을 변경할 수 없습니다.
다음 샘플에서는 V3 파서를 사용하여 HL7v2 저장소를 만드는 방법을 보여줍니다.
콘솔
Google Cloud 콘솔에서 데이터 세트 페이지로 이동합니다.
HL7v2 저장소를 만들려는 데이터 세트를 선택합니다. 데이터 세트 페이지가 표시됩니다.
add_box 데이터 저장소 만들기를 클릭합니다. 데이터 저장소 만들기 페이지가 표시됩니다.
유형 메뉴에서 HL7v2를 선택합니다.
ID 필드에 HL7v2 저장소 이름을 입력합니다. 이름은 데이터 세트 내에서 고유해야 합니다. 추가 이름 지정 요구사항은 허용되는 문자 및 크기 요구사항을 참조하세요.
다음을 클릭합니다. HL7v2 저장소 구성 섹션이 표시됩니다.
다음 설정을 구성합니다.
- 버전 섹션에서 기본 V3 선택을 변경하지 않고 그대로 둡니다.
- 헤더 없이 HL7v2 메시지를 만들고 수집하도록 허용하려면 null 메시지 헤더(MSH) 허용을 선택합니다.
- 커스텀 세그먼트 종결자를 설정하려면 커스텀 세그먼트 종결자 설정을 클릭하고 세그먼트 종결자 필드에 종료자를 입력합니다. 자세한 내용은 세그먼트 종결자 설정을 참조하세요.
- 이미 HL7v2 저장소에 있는 HL7v2 메시지와 동일한 원시 바이트가 있는 수신 HL7v2 메시지를 거부하려면 중복 메시지 거부를 선택합니다.
다음을 클릭합니다. Cloud Pub/Sub 알림 수신 섹션이 표시됩니다.
HL7v2 저장소에서 임상 이벤트가 발생할 때 Pub/Sub 알림을 받으려면 Pub/Sub 주제를 지정합니다. HL7v2 저장소에서 구성하려면 먼저 주제가 있어야 합니다.
다음을 클릭합니다. 라벨을 추가하여 데이터 저장소 구성 섹션이 표시됩니다.
HL7v2 저장소에 키/값 라벨을 하나 이상 추가하려면 add 라벨 추가를 클릭합니다. 리소스 라벨에 대한 자세한 내용은 리소스 라벨 사용을 참조하세요.
만들기를 클릭합니다. 데이터 세트 페이지가 표시되고 HL7v2 저장소가 데이터 저장소 테이블에 표시됩니다.
gcloud
HL7v2 저장소를 만들려면 gcloud healthcare hl7v2-stores create
명령어를 실행합니다.
아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID
: Google Cloud 프로젝트의 IDLOCATION
: 데이터 세트 위치DATASET_ID
: HL7v2 저장소의 상위 데이터 세트HL7V2_STORE_ID
: HL7v2 저장소 문자 및 크기 요구사항이 적용되는 HL7v2 저장소의 식별자
다음 명령어를 실행합니다.
Linux, macOS 또는 Cloud Shell
gcloud healthcare hl7v2-stores create HL7V2_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --parser-version=v3
Windows(PowerShell)
gcloud healthcare hl7v2-stores create HL7V2_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --parser-version=v3
Windows(cmd.exe)
gcloud healthcare hl7v2-stores create HL7V2_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --parser-version=v3
다음과 비슷한 응답이 표시됩니다.
응답
Created hl7V2Store [HL7V2_STORE_ID].
REST
HL7v2 저장소를 만들려면 projects.locations.datasets.hl7V2Stores.create
메서드를 사용합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID
: Google Cloud 프로젝트의 IDLOCATION
: 데이터 세트 위치DATASET_ID
: HL7v2 저장소의 상위 데이터 세트HL7V2_STORE_ID
: HL7v2 저장소 문자 및 크기 요구사항이 적용되는 HL7v2 저장소의 식별자
JSON 요청 본문:
{ "parserConfig": { "version": "V3" } }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 request.json
파일에 저장합니다.
터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.
cat > request.json << 'EOF' { "parserConfig": { "version": "V3" } } EOF
그런 후 다음 명령어를 실행하여 REST 요청을 전송합니다.
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores?hl7V2StoreId=HL7V2_STORE_ID"
PowerShell
요청 본문을 request.json
파일에 저장합니다.
터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.
@' { "parserConfig": { "version": "V3" } } '@ | Out-File -FilePath request.json -Encoding utf8
그런 후 다음 명령어를 실행하여 REST 요청을 전송합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores?hl7V2StoreId=HL7V2_STORE_ID" | Select-Object -Expand Content
API 탐색기
요청 본문을 복사하고 메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 요청 본문을 이 도구에 붙여넣고 다른 필수 필드를 입력한 후 실행을 클릭합니다.
다음과 비슷한 JSON 응답이 표시됩니다.
Go
Java
Node.js
Python
Pub/Sub 주제 및 필터 사용
Pub/Sub 및 HL7v2 스토어가 포함된 필터는 특히 TCP/IP 연결을 통해 HL7v2 메시지를 전송할 때 일반적으로 사용됩니다.
이 페이지의 일부 예시에서는 Cloud Healthcare API에서 HL7v2 스토어의 임상 이벤트 알림을 보내는 기존 Pub/Sub 주제를 구성하는 방법을 보여줍니다. 기존 Pub/Sub 주제와 필터의 목록을 지정하면 Cloud Healthcare API에서 여러 주제로 알림을 보낼 수 있으며 개발자는 필터를 사용하여 전송되는 알림을 제한할 수 있습니다. Pub/Sub 주제 및 필터를 구성하는 방법에 대한 자세한 내용은 HL7v2 알림 및 HL7v2 알림 보기를 참조하세요.
HL7v2 저장소 수정
다음 샘플에서는 Cloud Healthcare API가 HL7v2 저장소 변경사항 알림을 보내기 위해 사용하는 Pub/Sub 주제와 필터의 목록을 수정하는 방법을 보여줍니다.
또한 여러 샘플에서는 HL7v2 저장소에서 라벨을 수정하는 방법을 보여줍니다.
Pub/Sub 주제를 지정할 때 다음 샘플과 같이 주제에 대해 정규화된 URI를 입력합니다.projects/PROJECT_ID/topics/PUBSUB_TOPIC
콘솔
HL7v2 저장소를 수정하려면 다음 단계를 완료하세요.
- Google Cloud 콘솔에서 데이터 세트 페이지로 이동합니다.
- 수정할 HL7v2 저장소가 포함된 데이터 세트를 선택합니다.
- 데이터 스토어 목록에서 수정할 데이터 스토어를 클릭합니다.
- HL7v2 저장소의 구성을 수정하려면 HL7v2 저장소 구성을 클릭합니다.
HL7v2 저장소의 구성 옵션에 대한 자세한 내용은 HL7v2 저장소 만들기를 참조하세요. - 데이터 스토어에 대해 Pub/Sub 주제를 구성하려면 Pub/Sub 주제 추가를 클릭하고 주제 이름을 선택합니다. Pub/Sub 주제를 지정할 때 다음 샘플과 같이 주제에 대해 정규화된 URI를 입력합니다.
projects/PROJECT_ID/topics/PUBSUB_TOPIC
- Pub/Sub 주제를 추가한 경우 완료를 클릭합니다.
- 저장소에 라벨을 하나 이상 추가하려면 리소스 라벨 사용을 참조하세요. 라벨, 라벨 추가를 차례로 클릭하고 키/값 라벨을 입력합니다. 리소스 라벨에 대한 자세한 내용은
- 저장을 클릭합니다.
gcloud
gcloud CLI는 이 작업을 지원하지 않습니다. 대신 Google Cloud 콘솔, curl
, PowerShell 또는 원하는 언어를 사용하세요.
REST
HL7v2 저장소를 수정하려면 projects.locations.datasets.hl7V2Stores.patch
메서드를 사용합니다.
다음 샘플을 실행하기 전에 프로젝트에 하나 이상의 Pub/Sub 주제를 만들어야 합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트의 ID
- LOCATION: 데이터 세트 위치
- DATASET_ID: HL7v2 저장소의 상위 데이터 세트
- HL7V2_STORE_ID: HL7v2 저장소 ID
- PUBSUB_TOPIC1: 데이터 스토어에서 이벤트가 발생할 때 메시지가 게시되는 Pub/Sub 주제
- FILTER1: PUBSUB_TOPIC1에 게시된 메시지 매칭에 사용되는 문자열
유효한 필터 값의 예시는
filter
를 참조하세요. - PUBSUB_TOPIC2: 메시지가 게시되는 Pub/Sub 주제
- FILTER2: PUBSUB_TOPIC2에 게시된 메시지 매칭에 사용되는 문자열
- KEY1: 첫 번째 라벨 키
- VALUE1: 첫 번째 라벨 값
- KEY2: 두 번째 라벨 키
- VALUE2: 두 번째 라벨 값
JSON 요청 본문:
{ 'notificationConfigs': [ { 'pubsubTopic': 'projects/PROJECT_ID/topics/PUBSUB_TOPIC1', 'filter' : 'FILTER1' }, { 'pubsubTopic': 'projects/PROJECT_ID/topics/PUBSUB_TOPIC2', 'filter': 'FILTER2' }, ], 'labels': { 'KEY1':'VALUE1', 'KEY2':'VALUE2' } }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 request.json
파일에 저장합니다.
터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.
cat > request.json << 'EOF' { 'notificationConfigs': [ { 'pubsubTopic': 'projects/PROJECT_ID/topics/PUBSUB_TOPIC1', 'filter' : 'FILTER1' }, { 'pubsubTopic': 'projects/PROJECT_ID/topics/PUBSUB_TOPIC2', 'filter': 'FILTER2' }, ], 'labels': { 'KEY1':'VALUE1', 'KEY2':'VALUE2' } } EOF
그런 후 다음 명령어를 실행하여 REST 요청을 전송합니다.
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID?updateMask=notificationConfigs,labels"
PowerShell
요청 본문을 request.json
파일에 저장합니다.
터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.
@' { 'notificationConfigs': [ { 'pubsubTopic': 'projects/PROJECT_ID/topics/PUBSUB_TOPIC1', 'filter' : 'FILTER1' }, { 'pubsubTopic': 'projects/PROJECT_ID/topics/PUBSUB_TOPIC2', 'filter': 'FILTER2' }, ], 'labels': { 'KEY1':'VALUE1', 'KEY2':'VALUE2' } } '@ | Out-File -FilePath request.json -Encoding utf8
그런 후 다음 명령어를 실행하여 REST 요청을 전송합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID?updateMask=notificationConfigs,labels" | Select-Object -Expand Content
API 탐색기
요청 본문을 복사하고 메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 요청 본문을 이 도구에 붙여넣고 다른 필수 필드를 입력한 후 실행을 클릭합니다.
다음과 비슷한 JSON 응답이 표시됩니다.
Go
Java
Node.js
Python
HL7v2 저장소 세부정보 가져오기
다음 샘플은 HL7v2 저장소에 대해 세부정보를 가져오는 방법을 보여줍니다.
콘솔
HL7v2 저장소의 세부정보를 보려면 다음 안내를 따르세요.
- Google Cloud 콘솔에서 데이터 세트 페이지로 이동합니다.
- 보려는 HL7v2 저장소가 포함된 데이터 세트를 선택합니다.
- HL7v2 저장소의 이름을 클릭합니다.
Datastore 세부정보 페이지에 선택한 HL7v2 저장소의 세부정보가 표시됩니다.
gcloud
HL7v2 저장소에 대한 세부정보를 가져오려면 gcloud healthcare hl7v2-stores describe
명령어를 실행합니다.
아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.
- LOCATION: 데이터 세트 위치
- DATASET_ID: HL7v2 저장소의 상위 데이터 세트
- HL7V2_STORE_ID: HL7v2 스토어 ID
다음 명령어를 실행합니다.
Linux, macOS 또는 Cloud Shell
gcloud healthcare hl7v2-stores describe HL7V2_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows(PowerShell)
gcloud healthcare hl7v2-stores describe HL7V2_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows(cmd.exe)
gcloud healthcare hl7v2-stores describe HL7V2_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
다음과 비슷한 응답이 표시됩니다.
Hl7V2Store
리소스에서 필드를 구성한 경우 응답에도 표시됩니다.
응답
... name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID ...
REST
HL7v2 저장소에 대해 세부정보를 가져오려면 projects.locations.datasets.hl7V2Stores.get
메서드를 사용합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트의 ID
- LOCATION: 데이터 세트 위치
- DATASET_ID: HL7v2 저장소의 상위 데이터 세트
- HL7V2_STORE_ID: HL7v2 스토어 ID
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
다음 명령어를 실행합니다.
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID"
PowerShell
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID" | Select-Object -Expand Content
API 탐색기
메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 모든 필수 필드를 입력하고 실행을 클릭합니다.
다음과 비슷한 응답이 표시됩니다.
Hl7V2Store
리소스에서 필드를 구성한 경우 응답에도 표시됩니다.
Go
Java
Node.js
Python
데이터 세트의 HL7v2 저장소 나열
다음 샘플은 데이터 세트의 HL7v2 저장소를 나열하는 방법을 보여줍니다.
콘솔
데이터 세트의 데이터 스토어를 보려면 다음 안내를 따르세요.
- Google Cloud 콘솔에서 데이터 세트 페이지로 이동합니다.
- 보려는 데이터 스토어가 포함된 데이터 세트를 선택합니다.
gcloud
데이터 세트의 HL7v2 저장소를 나열하려면 gcloud healthcare hl7v2-stores list
명령어를 실행합니다.
아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.
- LOCATION: 데이터 세트 위치
- DATASET_ID: HL7v2 저장소의 상위 데이터 세트
다음 명령어를 실행합니다.
Linux, macOS 또는 Cloud Shell
gcloud healthcare hl7v2-stores list --dataset=DATASET_ID \ --location=LOCATION
Windows(PowerShell)
gcloud healthcare hl7v2-stores list --dataset=DATASET_ID ` --location=LOCATION
Windows(cmd.exe)
gcloud healthcare hl7v2-stores list --dataset=DATASET_ID ^ --location=LOCATION
다음과 비슷한 응답이 표시됩니다.
Hl7V2Store
리소스에서 필드를 구성한 경우 응답에도 표시됩니다.
ID LOCATION TOPIC HL7V2_STORE_ID LOCATION projects/PROJECT_ID/topics/PUBSUB_TOPIC PUBSUB_TOPIC ...
REST
데이터 세트의 HL7v2 저장소를 나열하려면 projects.locations.datasets.hl7V2Stores.list
메서드를 사용합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트의 ID
- LOCATION: 데이터 세트 위치
- DATASET_ID: HL7v2 저장소의 상위 데이터 세트
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
다음 명령어를 실행합니다.
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores"
PowerShell
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores" | Select-Object -Expand Content
API 탐색기
메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 모든 필수 필드를 입력하고 실행을 클릭합니다.
다음과 비슷한 응답이 표시됩니다.
Hl7V2Store
리소스에서 필드를 구성한 경우 응답에도 표시됩니다.
Go
Java
Node.js
Python
HL7v2 저장소 삭제
다음 샘플은 HL7v2 저장소를 삭제하는 방법을 보여줍니다.
콘솔
데이터 스토어를 삭제하려면 다음 안내를 따르세요.
- Google Cloud 콘솔에서 데이터 세트 페이지로 이동합니다.
- 삭제할 데이터 스토어가 포함된 데이터 세트를 선택합니다.
- 삭제할 데이터 스토어의 작업 드롭다운 목록에서 삭제를 선택합니다.
- 확인하려면 데이터 스토어 이름을 입력한 다음 삭제를 클릭합니다.
gcloud
HL7v2 저장소를 삭제하려면 gcloud healthcare hl7v2-stores delete
명령어를 실행합니다.
아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.
- LOCATION: 데이터 세트 위치
- DATASET_ID: HL7v2 저장소의 상위 데이터 세트
- HL7V2_STORE_ID: HL7v2 스토어 ID
다음 명령어를 실행합니다.
Linux, macOS 또는 Cloud Shell
gcloud healthcare hl7v2-stores delete HL7V2_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows(PowerShell)
gcloud healthcare hl7v2-stores delete HL7V2_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows(cmd.exe)
gcloud healthcare hl7v2-stores delete HL7V2_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Deleted hl7v2Store [HL7V2_STORE_ID].
REST
HL7v2 저장소를 삭제하려면 projects.locations.datasets.hl7V2Stores.delete
메서드를 사용합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트의 ID
- LOCATION: 데이터 세트 위치
- DATASET_ID: HL7v2 저장소의 상위 데이터 세트
- HL7V2_STORE_ID: HL7v2 스토어 ID
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
다음 명령어를 실행합니다.
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID"
PowerShell
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID" | Select-Object -Expand Content
API 탐색기
메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 모든 필수 필드를 입력하고 실행을 클릭합니다.