Adatregisztrációs adatbázis létrehozása
Az adatregisztrációs szolgáltatással adattartalmat regisztrálhat egy Azure Storage-fiókban a Azure Maps-fiókjával. Ilyen adat lehet például az Azure Maps Geofencing szolgáltatásban használt Geofences-gyűjtemény. Egy másik példa a rajzcsomagokat (DWG) vagy GeoJSON-fájlokat tartalmazó ZIP-fájlok, amelyeket Azure Maps Creator a beltéri térképek létrehozásához vagy frissítéséhez használ.
Előfeltételek
Fontos
- Ez a cikk a
us.atlas.microsoft.com
földrajzi URL-címet használja. Ha a fiókját nem a Egyesült Államok hozta létre, más földrajzi URL-címet kell használnia. További információ: Hozzáférés a létrehozói szolgáltatásokhoz. - A cikkben szereplő URL-példákban a következőt kell lecserélnie:
{Azure-Maps-Subscription-key}
Azure Maps előfizetési kulccsal.{udid}
az adatregisztrációs adatbázis felhasználói adatazonosítójával. További információ: A felhasználói adatok azonosítója.
Adatok regisztrálásának előkészítése Azure Maps
Ahhoz, hogy adatokat regisztrálhasson Azure Maps, létre kell hoznia egy környezetet, amely tartalmazza az összes szükséges összetevőt. Szüksége van egy tárfiókra egy vagy több tárolóval, amely a regisztrálni kívánt fájlokat és a hitelesítéshez felügyelt identitásokat tárolja. Ez a szakasz azt ismerteti, hogyan készítheti elő az Azure-környezetet az adatok Azure Maps való regisztrálására.
Felügyelt identitások létrehozása
Kétféle felügyelt identitás létezik: rendszer által hozzárendelt és felhasználó által hozzárendelt. A rendszer által hozzárendelt felügyelt identitások életciklusa az őket létrehozó erőforráshoz van kötve. A felhasználó által hozzárendelt felügyelt identitások több erőforráson is használhatók. További információ: Azure-erőforrások felügyelt identitásai.
Az alábbi lépésekkel létrehozhat egy felügyelt identitást, és hozzáadhatja azt a Azure Maps fiókjához.
Rendszer által hozzárendelt felügyelt identitás létrehozása:
- Nyissa meg Azure Maps fiókját a Azure Portal.
- A bal oldali menüben válassza az Identitás lehetőséget.
- Állítsa az Állapot beállítástBe értékre.
További információ: Azure-erőforrások felügyelt identitásai.
Tároló létrehozása és adatfájlok feltöltése
Mielőtt fájlokat ad egy adatregisztrációs adatbázishoz, fel kell töltenie őket az Azure Storage-fiók egyik tárolójába. A tárolók hasonlóak a fájlrendszer könyvtáraihoz, így vannak rendszerezve a fájlok az Azure Storage-fiókban.
Ha tárolót szeretne létrehozni a Azure Portal, kövesse az alábbi lépéseket:
Az Azure Storage-fiókban válassza a tárolókat a navigációs panel Adattároló szakaszában.
Az Új tároló panel megjelenítéséhez válassza a + Tároló lehetőséget a Tárolók panelen.
A tároló létrehozásához válassza a Létrehozás lehetőséget.
A tároló létrehozása után fájlokat tölthet fel a tárolóba.
A tároló létrehozása után válassza ki.
Válassza a Feltöltés lehetőséget az eszköztáron, és válasszon ki egy vagy több fájlt
Kattintson a Feltöltés gombra.
Adattár hozzáadása
Miután létrehozott egy Azure Storage-fiókot egy vagy több tárolóba feltöltött fájlokkal, készen áll arra, hogy létrehozza azt az adattárat, amely a tárfiókokat a Azure Maps-fiókjához kapcsolja.
Fontos
Az Azure Maps-fiókhoz társított összes tárfióknak ugyanazon a földrajzi helyen kell lennie. További információ: Azure Maps szolgáltatás földrajzi hatóköre.
Megjegyzés
Ha nincs tárfiókja, olvassa el a Tárfiók létrehozása című témakört.
Válassza az Adattár lehetőséget a Azure Maps-fiók bal oldali menüjében.
Válassza a Hozzáadás gombot. A jobb oldalon megjelenik az Add datastore (Adattár hozzáadása ) képernyő.
Adja meg a kívánt adattár-azonosítót , majd válassza ki az Előfizetés nevét és a Tárfiókot a legördülő listából.
Válassza a Hozzáadás lehetőséget.
Az új adattár ekkor megjelenik az adattárak listájában.
Szerepkörök hozzárendelése felügyelt identitásokhoz, és hozzáadása az adattárhoz
Miután létrehozta a felügyelt identitásokat és az adattárat, hozzáadhatja a felügyelt identitásokat az adattárhoz, és egyidejűleg hozzárendelheti őket a Közreműködő és a Storage-blobadat-olvasó szerepkörhöz. Bár közvetlenül a felügyelt identitásokban vagy tárfiókokban is hozzáadhat szerepköröket a felügyelt identitásokhoz, amelyeket egyszerűen elvégezhet, miközben közvetlenül az adattár paneljén társítja őket a Azure Maps-adattárhoz.
Megjegyzés
Az adattárhoz társított minden felügyelt identitáshoz rendelkeznie kell a közreműködői és a storage-blobadat-olvasó szerepkörökkel. Ha nem rendelkezik a szerepkörök felügyelt identitásokhoz való megadásához szükséges engedélyekkel, forduljon az Azure-rendszergazdához. Szerepkörök hozzárendelése a felügyelt identitásokhoz és társítása egy adattárral:
A Azure Maps-fiók bal oldali menüjében válassza az Adattár lehetőséget.
Válasszon ki egy vagy több adattárat a listából, majd a Szerepkörök hozzárendelése lehetőséget.
Válassza ki a legördülő listából a kiválasztott adattár(ok)hoz társítandó felügyelt identitást .
A Szerepkörök listában válassza a Közreműködő és a Storage-blobadatok olvasója lehetőséget is a hozzárendeléshez .
Válassza a Hozzárendelés gombot.
Adatregisztrációs adatbázis tulajdonságai
A Azure Maps-fiókjában létrehozott adattárral készen áll az adatregisztrációs adatbázis létrehozásához szükséges tulajdonságok összegyűjtésére.
Vannak olyan AzureBlob-tulajdonságok, amelyeket a HTTP-kérés törzsében ad át, és az URL-címben átadott felhasználói adatazonosító .
Az AzureBlob
A AzureBlob
egy JSON-objektum, amely meghatározza az adatregisztrációs adatbázis létrehozásához szükséges tulajdonságokat.
Tulajdonság | Leírás |
---|---|
kind |
Meghatározza, hogy milyen típusú objektum legyen regisztrálva. Jelenleg az AzureBlob az egyetlen támogatott típus. |
dataFormat |
A blobUrl fájl adatformátuma. Formátuma lehet GeoJSON a térbeli szolgáltatáshoz, vagy ZIP a konvertálási szolgáltatáshoz. |
msiClientId |
Az adatregisztrációs adatbázis létrehozásához használt felügyelt identitás azonosítója. |
linkedResource |
A Azure Maps-fiókban regisztrált adattár azonosítója. Az adattár a regisztrált fájlra mutató hivatkozást tartalmaz. |
blobUrl |
A tárolóba importált AzurebBlob helyére mutató URL-cím. |
Az alábbi két szakasz részletesen ismerteti, hogyan szerezheti be az msiClientId, blobUrl tulajdonságokhoz használandó értékeket.
Az msiClientId tulajdonság
A msiClientId
tulajdonság az adatregisztrációs adatbázis létrehozásához használt felügyelt identitás azonosítója. A felügyelt identitások két típusa létezik: rendszer által hozzárendelt és felhasználó által hozzárendelt. A rendszer által hozzárendelt felügyelt identitások életciklusa az őket létrehozó erőforráshoz van kötve. A felhasználó által hozzárendelt felügyelt identitások több erőforráson is használhatók. További információt az Azure-erőforrások felügyelt identitásai című témakörben talál.
A rendszer által hozzárendelt felügyelt identitások használatakor nem kell értéket megadnia a msiClientId
tulajdonsághoz. Az adatregisztrációs szolgáltatás automatikusan a Azure Maps fiók rendszer által hozzárendelt identitását használja null érték eseténmsiClientId
.
A blobUrl tulajdonság
A blobUrl
tulajdonság a regisztrált fájl elérési útja. Ezt az értéket a hozzá hozzáadott tárolóból szerezheti be. adatregisztrációs adatbázis
Válassza ki a tárfiókot a Azure Portal.
A bal oldali menüben válassza a Tárolók lehetőséget.
Megjelenik a tárolók listája. Válassza ki a regisztrálni kívánt fájlt tartalmazó tárolót.
Ekkor megnyílik a tároló, amelyen a korábban feltöltött fájlok listája látható.
Jelölje ki a kívánt fájlt, majd másolja ki az URL-címet.
A felhasználói adatok azonosítója
Az adatregisztrációs adatbázis felhasználói adatazonosítója (udid
) egy felhasználó által definiált GUID, amely megfelel a következő Regex-mintának:
^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$
Tipp
Ez udid
egy felhasználó által definiált GUID, amelyet meg kell adni egy adatregisztrációs adatbázis létrehozásakor. Ha biztos szeretne lenni abban, hogy globálisan egyedi azonosítóval (GUID) rendelkezik, érdemes lehet létrehozni egy GUID-generáló eszközt, például a Guidgen.exe parancssori programot (a Visual Studióval elérhető).
Adatregisztrációs adatbázis létrehozása
Most, hogy rendelkezik a tárfiókjával a Azure Maps-fiókhoz társított kívánt fájlokkal az adattáron keresztül, és összegyűjtötte az összes szükséges tulajdonságot, készen áll arra, hogy az adatregisztrációs API-val regisztrálja ezeket a fájlokat. Ha több fájlt szeretne regisztrálni az Azure Storage-fiókjában, minden fájlhoz futtatnia kell a regisztrációs kérelmet (udid
).
Megjegyzés
Egy Azure Maps adattárban regisztrálható fájlok maximális mérete egy gigabájt.
Adatregisztrációs adatbázis létrehozása:
Adja meg a HTTP-kérés törzsében az adatjegyzékbe felvett tárfiókra való hivatkozáshoz szükséges információkat. Az információknak JSON formátumban kell lenniük, és a következő mezőket kell tartalmazniuk:
{ "kind": "AzureBlob", "azureBlob": { "dataFormat": "geojson", "linkedResource": "{datastore ID}", "blobUrl": "https://teststorageaccount.blob.core.windows.net/testcontainer/test.geojson" } }
Megjegyzés
Rendszer által hozzárendelt felügyelt identitások használatakor hibaüzenet jelenik meg, ha megad egy értéket az msiClientId tulajdonsághoz a HTTP-kérelemben.
A HTTP-kérelem törzsében szükséges tulajdonságokról további információt az Adatregisztrációs adatbázis tulajdonságai című témakörben talál.
Miután elkészült a HTTP-kérés törzse, hajtsa végre a következő HTTP PUT kérést:
https://us.atlas.microsoft.com/dataRegistries/{udid}?api-version=2023-06-01&subscription-key={Your-Azure-Maps-Subscription-key}
A tulajdonságról további információt a
udid
Felhasználói adatok azonosítója című témakörben talál.Másolja ki az Operation-Location kulcs értékét a válaszfejlécből.
Tipp
Ha egy korábban regisztrált fájl tartalmát módosítják, az nem fogja ellenőrizni az adatokat, és nem lesz használható a Azure Maps, amíg újra nem regisztrálják. Fájl újbóli regisztrálásához futtassa újra a regisztrációs kérést, és adja át ugyanazt az AzureBlobot , amelyet az eredeti regisztráció létrehozásához használt. Az Operation-Location kulcs értéke az az állapot URL-cím, amellyel a következő szakaszban ellenőrizheti az adatregisztrációs adatbázis létrehozásának állapotát. Ez tartalmazza a Művelet lekérése API által használt műveletazonosítót.
Megjegyzés
Az Operation-Location kulcs értéke nem tartalmazza a subscription-key
értéket, ezt hozzá kell adnia a kérelem URL-címéhez, amikor azt használja az adatregisztrációs adatbázis létrehozási állapotának ellenőrzéséhez.
Az adatregisztrációs adatbázis létrehozásának állapotának ellenőrzése
Az adatregisztrációs adatbázis létrehozásának állapotának ellenőrzéséhez (opcionálisan) adja meg az adatregisztrációs adatbázis létrehozása szakaszban másolt állapot URL-címet, és adja hozzá az előfizetési kulcsot lekérdezési sztringparaméterként. A kérésnek a következő URL-címhez hasonlóan kell kinéznie:
https://us.atlas.microsoft.com/dataRegistries/operations/{udid}?api-version=2023-06-01&subscription-key={Your-Azure-Maps-Primary-Subscription-key}
Az adatregisztrációs adatbázis összes fájljának listájának lekérése
A List kéréssel lekérheti az Azure Maps-fiókban regisztrált összes fájl listáját:
https://us.atlas.microsoft.com/dataRegistries?api-version=2023-06-01&subscription-key={Azure-Maps-Subscription-key}
Az alábbi minta három lehetséges állapotot mutat be, amelyek befejeződtek, futnak és sikertelenek:
{
"value": [
{
"udid": "f6495f62-94f8-0ec2-c252-45626f82fcb2",
"description": "Contoso Indoor Design",
"kind": "AzureBlob",
"azureBlob": {
"dataFormat": "zip",
"msiClientId": "3263cad5-ed8b-4829-b72b-3d1ba556e373",
"linkedResource": "my-storage-account",
"blobUrl": "https://mystorageaccount.blob.core.windows.net/my-container/my/blob/path1.zip",
"sizeInBytes": 29920,
"contentMD5": "CsFxZ2YSfxw3cRPlqokV0w=="
},
"status": "Completed"
},
{
"udid": "8b1288fa-1958-4a2b-b68e-13a7i5af7d7c",
"kind": "AzureBlob",
"azureBlob": {
"dataFormat": "geojson",
"msiClientId": "3263cad5-ed8b-4829-b72b-3d1ba556e373",
"linkedResource": "my-storage-account",
"blobUrl": "https://mystorageaccount.blob.core.windows.net/my-container/my/blob/path2.geojson",
"sizeInBytes": 1339
},
"status": "Running"
},
{
"udid": "7c1288fa-2058-4a1b-b68f-13a6h5af7d7c",
"description": "Contoso Geofence GeoJSON",
"kind": "AzureBlob",
"azureBlob": {
"dataFormat": "geojson",
"linkedResource": "my-storage-account",
"blobUrl": "https://mystorageaccount.blob.core.windows.net/my-container/my/blob/path3.geojson",
"sizeInBytes": 1650,
"contentMD5": "rYpEfIeLbWZPyaICGEGy3A=="
},
"status": "Failed",
"error": {
"code": "ContentMD5Mismatch",
"message": "Actual content MD5: sOJMJvFParkSxBsvvrPOMQ== doesn't match expected content MD5: CsFxZ2YSfxw3cRPlqokV0w==."
}
}
]
}
A listakérés futtatásakor visszaadott adatok hasonlóak a beállításjegyzék létrehozásakor megadott adatokhoz, néhány kiegészítéssel:
property | leírás |
---|---|
contentMD5 | A regisztrált fájl tartalmából létrehozott MD5-kivonat. További információ: Adatérvényesítés |
sizeInBytes | A tartalom mérete bájtban. |
Adatregisztrációs adatbázis cseréje
Ha egy korábban regisztrált fájlt egy másik fájlra kell cserélnie, futtassa újra a regisztrációs kérést, és adja át ugyanazt az AzureBlobot , amelyet az eredeti regisztráció létrehozásához használt, a blobUrl kivételével. A BlobUrl
módosítást úgy kell módosítani, hogy az az új fájlra mutasson.
Adatkiértékelés
Amikor az adatregisztrációs API-val regisztrál egy fájlt Azure Maps, a rendszer létrehoz egy MD5-kivonatot a fájl tartalmából, kódolással 128 bites ujjlenyomatba, és a tulajdonságba AzureBlob
contentMD5
menti. A tulajdonságban contentMD5
tárolt MD5 kivonat biztosítja a fájl adatintegritását. Mivel az MD5 kivonatolási algoritmus mindig ugyanazt a kimenetet állítja elő ugyanazzal a bemenettel, az adatérvényesítési folyamat összehasonlíthatja a contentMD5
fájl tulajdonságát, amikor regisztrálva lett az Azure Storage-fiókban lévő fájl kivonatával annak ellenőrzéséhez, hogy az ép és nem módosított-e. Ha a kivonat nem ugyanaz, az ellenőrzés sikertelen lesz. Ha a mögöttes tárfiókban lévő fájl megváltozik, az ellenőrzés sikertelen lesz. Ha módosítania kell egy Azure Maps regisztrált fájl tartalmát, újra regisztrálnia kell.