$load & /fhir/$load

You can efficiently load data into Aidbox in ndjson gz format from external web service or bucket. There are two versions of $load - /$load and /[resourceType]/$load. First can load multiple resource types from one ndjson file, second is more efficient, but loads only for a specific resource type. Both operations accept body with source element, which should be publicly available url. If you want to secure your import use Signed URLs by Amazon S3 or Google Storage.

There are two versions of this operation - /fhir/$load accepts data in FHIR format, /$load works with Aidbox & FHIR formats.

Resource requirements for all load operations:

Load 100 synthea Patients to Aidbox (see 🎓 Synthea by Bulk APi):

POST /fhir/Patient/$load
Content-Type: text/yaml

source: 'https://storage.googleapis.com/aidbox-public/synthea/100/Patient.ndjson.gz'

#resp
{total: 124}

update: true

By default for performance reasons $load does raw upsert into resource table without updating history. If you want to store the previous version of resources in history, you have to set update = true, with this flag Aidbox will update history for updated resources.

POST /fhir/Patient/$load
Content-Type: text/yaml

source: <new-version-of-data>
update: true

strip-nulls: true

By default for performance reasons $load does raw upsert into the resource table without cleaning up null values from imported resources. To make import behave in the same way as the Create operation, use options strip-nulls: true

POST /fhir/Patient/$load
Content-Type: text/yaml

source: <new-version-of-data>
strip-nulls: true

merge: object literal

It's possible to merge some data into every loaded resource using merge option. A shallow merge will be used.

POST /fhir/Patient/$load
Content-Type: text/yaml

source: <new-version-of-data>
merge:
  active: true

$load multiple resource types

Or load the whole synthea package:

POST /fhir/$load
Content-Type: text/yaml

source: 'https://storage.googleapis.com/aidbox-public/synthea/100/all.ndjson.gz'

# resp

{CarePlan: 356, Observation: 20382, MedicationAdministration: 150, .... }

Import local file

Sometimes you want to import local file into local Aidbox. Possible solutions for local development:

Add volume to the aidboxone container (not aidboxdb):

volumes:
- ./Encounter.ndjson.gz:/resources/Encounter.ndjson.gz
# url: file:///resources/Encounter.ndjson.gz

Use tunneling e.g. ngrok:&x20;

python3 -m http.server  ngrok http 8000 # url: https://<...>.ngrok-free.app/Encounter.ndjson.gz