Megosztás a következőn keresztül:

Adatregisztrációs adatbázis létrehozása

  • Cikk

Feljegyzés

Az Azure Maps adatregisztrációs szolgáltatásának kivonása

Az Azure Maps adatregisztrációs szolgáltatása elavult, és 25. 09.30-án megszűnik. További információ: Az Azure Maps adatregisztrációs adatbázisának élettartamának megszűnése című közleménye.

Az adatregisztrációs szolgáltatással adattartalmat regisztrálhat egy Azure Storage-fiókban az 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 az 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ó: Access to Creator services.
  • A cikkben szereplő URL-példákban a következőt kell lecserélnie:

Adatok regisztrálásának előkészítése az Azure Mapsben

Ahhoz, hogy adatokat regisztrálhasson az Azure Mapsben, 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 tartalmazza a regisztrálni kívánt fájlokat és a hitelesítéshez felügyelt identitásokat. Ez a szakasz azt ismerteti, hogyan készítheti elő az Azure-környezetet az adatok Azure Mapsben való regisztrálására.

Felügyelt identitások létrehozása

A felügyelt identitások két típusa létezik: a rendszer által hozzárendelt és a 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ókért tekintse meg az Azure-erőforrások felügyelt identitását.

A következő lépésekkel létrehozhat egy felügyelt identitást, és felveheti azt az Azure Maps-fiókjába.

Rendszer által hozzárendelt felügyelt identitás létrehozása:

  1. Nyissa meg az Azure Maps-fiókját az Azure Portalon.
  2. Válassza az Identitás lehetőséget a bal oldali menü Beállítások szakaszában.
  3. Állítsa be az állapotot Be állásba.

További információkért tekintse meg az Azure-erőforrások felügyelt identitását.

Tároló létrehozása és adatfájlok feltöltése

Mielőtt fájlokat ad hozzá egy adatregisztrációs adatbázishoz, fel kell töltenie őket egy tárolóba az Azure Storage-fiókjában. A tárolók hasonlóak a fájlrendszer könyvtáraihoz, így rendszerezik a fájlokat az Azure Storage-fiókban.

Tároló létrehozásához kövesse az alábbi lépéseket az Azure Portalon:

  1. Az Azure Storage-fiókban válassza a Tárolók lehetőséget a navigációs panel Adattárolás szakaszában.

  2. Válassza a + Tároló lehetőséget a Tárolók panelen az Új tároló panel megjelenítéséhez.

  3. A tároló létrehozásához válassza a Létrehozás lehetőséget.

    Képernyőkép egy Azure Storage-fiók új tárolóoldaláról.

    A tároló létrehozása után fájlokat tölthet fel a tárolóba.

  4. A tároló létrehozása után jelölje ki.

    Képernyőkép az azure-tárfiókban most létrehozott új tárolóról.

  5. Válassza a Feltöltés lehetőséget az eszköztárról, válasszon ki egy vagy több fájlt

  6. Kattintson a Feltöltés gombra.

    Képernyőkép a blob feltöltési oldaláról tároló létrehozásakor.

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 összekapcsolja a tárfiókokat az Azure Maps-fiókjával.

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.

Feljegyzés

Ha nincs tárfiókja, olvassa el a Tárfiók létrehozása című témakört.

  1. Az Azure Maps-fiók bal oldali menüjében válassza az Adattár lehetőséget.

  2. Válassza a Hozzáadás gombot. A jobb oldalon megjelenik egy Adattár hozzáadása képernyő.

  3. 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ákból.

  4. Válassza a Hozzáadás lehetőséget.

    Képernyőkép az adattár hozzáadása képernyőről.

Az új adattár mostantól 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ői és a tárolási blobadat-olvasó szerepkörökhöz. Bár közvetlenül a felügyelt identitásokban vagy tárfiókokban is felvehet szerepköröket a felügyelt identitásokhoz, amelyeket egyszerűen elvégezhet, miközben közvetlenül az adattár ablaktábláján társítja őket az Azure Maps-adattárhoz.

Feljegyzés

Az adattárhoz társított összes felügyelt identitáshoz hozzá kell adni a közreműködői és tárolási blobadat-olvasó szerepköröket. 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ásuk egy adattárral:

  1. Az Azure Maps-fiók bal oldali menüjében válassza az Adattár lehetőséget.

  2. Jelöljön ki egy vagy több adattárat a listából, majd rendeljen hozzá szerepköröket.

  3. Válassza ki azt a felügyelt identitást , amely a kiválasztott adattár(ok)hoz társítandó a legördülő listából.

  4. Válassza ki a Közreműködő és a Storage Blob-adatolvasót is a szerepkörök között a legördülő lista hozzárendeléséhez.

    Képernyőkép a szerepkörök adattárhoz való hozzárendelését ábrázoló képernyőről.

  5. Válassza a Hozzárendelés gombot.

Adatregisztrációs adatbázis tulajdonságai

Az Azure Maps-fiókban 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

Ez 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ú objektumot regisztrál. 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 (elavult 1) vagy zip a konvertálási szolgáltatáshoz (elavult 1).
msiClientId Az adatregisztrációs adatbázis létrehozásához használt felügyelt identitás azonosítója.
linkedResource Az Azure Maps-fiókban regisztrált adattár azonosítója.
Az adattár a regisztrált fájlra mutató hivatkozást tartalmaz.
blobUrl Az AzurebBlob helyére mutató URL-cím, amely a tárolóba importált fájl.

1 Az Azure Maps Creator, valamint az adatregisztrációs adatbázis és a térbeli szolgáltatások elavultak, és 9/30/25-én megszűnnek.

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: a rendszer által hozzárendelt és a 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ókért tekintse meg az Azure-erőforrások felügyelt identitását.

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 null érték esetén msiClientId automatikusan az Azure Maps-fiók rendszer által hozzárendelt identitását használja.

A blobUrl tulajdonság

A blobUrl tulajdonság a regisztrálandó fájl elérési útja. Ezt az értéket lekérheti abból a tárolóból, amelybe hozzáadták. adatregisztrációs adatbázis

  1. Válassza ki a tárfiókot az Azure Portalon.

  2. Válassza a Tárolók lehetőséget a bal oldali menüből.

  3. Megjelenik a tárolók listája. Válassza ki a regisztrálni kívánt fájlt tartalmazó tárolót.

  4. Megnyílik a tároló, amelyen a korábban feltöltött fájlok listája látható.

  5. Jelölje ki a kívánt fájlt, majd másolja ki az URL-címet.

    Képernyőkép a blobUrl tulajdonságként használt URL-cím kiválasztásáról.

A felhasználói adatazonosító

Az adatregisztrációs adatbázis felhasználói adatazonosítója (udid) egy felhasználó által definiált GUID, amely a következő Regex-mintának felel meg:

^[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 egy adatregisztrációs adatbázis létrehozásakor kell megadni. Ha biztos szeretne lenni abban, hogy globálisan egyedi azonosítóval (GUID) rendelkezik, érdemes lehet létrehoznia egy GUID-generáló eszközt, például a Guidgen.exe parancssori programot (a Visual Studióval érhető el).

Adatregisztrációs adatbázis létrehozása

Most, hogy rendelkezik a tárfiókjával az 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 (udid) futtatnia kell a regisztrációs kérelmet.

Feljegyzés

Az Azure Maps-adattárakban regisztrálható fájlok maximális mérete egy gigabájt.

Adatregisztrációs adatbázis létrehozása:

  1. Adja meg a HTTP-kérés törzsében az adatregisztrációs adatbázishoz hozzáadott 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"
    }
}

    Feljegyzés

    A 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.

  2. Ha 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 adatazonosító című témakörben talál.

  3. Másolja ki az Operation-Location kulcs értékét a válaszfejlécből.

Tipp.

Ha egy korábban regisztrált fájl tartalma módosul, az adatérvényesítés sikertelen lesz, és nem használható az Azure Mapsben, amíg újra nem regisztrálja. Fájl újbóli regisztrálásához futtassa újra a regisztrációs kérelmet, é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, amely tartalmazza a Művelet lekérése API által használt műveletazonosítót.

Feljegyzés

Az Operation-Location kulcs értéke nem tartalmazza az subscription-keyértéket, ezt hozzá kell adnia a kérelem URL-címéhez, amikor az adatregisztrációs adatbázis létrehozási állapotának ellenőrzéséhez használja.

Az adatregisztrációs adatbázis létrehozásának állapotának ellenőrzése

Az adatregisztrációs adatbázis létrehozási folyamatának állapotának ellenőrzéséhez írja be 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, befejezve, futtatva és sikertelenként:

{
  "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 néhány kiegészítéssel történő létrehozásakor megadott adatokhoz:

tulajdonság 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érelmet, és adja át ugyanazt az AzureBlobot , amelyet az eredeti regisztráció létrehozásához használt, kivéve a blobUrlt. A BlobUrl módosítást úgy kell módosítani, hogy az az új fájlra mutasson.

Adatellenőrzés engedélyezése

Amikor az adatregisztrációs API-val regisztrál egy fájlt az Azure Mapsben, a rendszer létrehoz egy MD5 kivonatot a fájl tartalmából, 128 bites ujjlenyomatba kódolással és a tulajdonságba AzureBlob contentMD5 való mentéssel. A tulajdonságban contentMD5 tárolt MD5 kivonat a fájl adatintegritásának biztosítására szolgál. Mivel az MD5 kivonatoló 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álták a fájl kivonatával az Azure Storage-fiókban, hogy ellenőrizze, hogy az érintetlen és nem módosított-e. Ha a kivonat nem ugyanaz, az érvényesítés meghiúsul. 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, az Azure Mapsben regisztrált fájl tartalmát, újra regisztrálnia kell.