Jak vytvořit registr dat

Článek
09/16/2024

Poznámka:

Vyřazení služby Azure Maps Data Registry

Služba Azure Maps Data Registry je teď zastaralá a bude vyřazena 30. 9. 25. Další informace najdete v tématu Oznámení o ukončení životnosti služby Azure Maps Data Registry.

Služba registru dat umožňuje registrovat datový obsah v účtu služby Azure Storage s účtem Azure Maps. Příkladem dat může být kolekce geofences používaných ve službě Azure Maps Geofencing. Dalším příkladem jsou soubory ZIP obsahující výkresové balíčky (DWG) nebo soubory GeoJSON, které Azure Maps Creator používá k vytváření nebo aktualizaci vnitřních map.

Požadavky

Důležité

Tento článek používá zeměpisnou us.atlas.microsoft.com adresu URL. Pokud se váš účet v USA nevytvořil, musíte použít jinou geografickou adresu URL. Další informace najdete v tématu Přístup ke službám Creator.
V příkladech adres URL v tomto článku budete muset nahradit:
- {Azure-Maps-Subscription-key}pomocí klíče předplatného Azure Maps.
- {udid} s ID dat uživatele vašeho registru dat. Další informace najdete v tématu ID dat uživatele.

Příprava na registraci dat v Azure Maps

Než budete moct zaregistrovat data v Azure Maps, musíte vytvořit prostředí obsahující všechny požadované součásti. Potřebujete účet úložiště s jedním nebo více kontejnery, které obsahují soubory, které chcete zaregistrovat a spravovat identity pro ověřování. Tato část vysvětluje, jak připravit prostředí Azure na registraci dat v Azure Maps.

Vytváření spravovaných identit

Existují dva typy spravovaných identit: přiřazené systémem a přiřazené uživatelem. Spravované identity přiřazené systémem mají svůj životní cyklus svázaný s prostředkem, který je vytvořil. Spravované identity přiřazené uživatelem je možné použít u více prostředků. Další informace najdete v tématu spravované identity pro prostředky Azure.

Pomocí následujících kroků vytvořte spravovanou identitu a přidejte ji do svého účtu Azure Maps.

přiřazené systémem
přiřazené uživatelem

Vytvořte spravovanou identitu přiřazenou systémem:

Na webu Azure Portal přejděte ke svému účtu Azure Maps.
V levé nabídce vyberte Možnost Identita v části Nastavení .
Přepněte stav na Zapnuto.

Další informace najdete v tématu spravované identity pro prostředky Azure.

Vytvoření kontejneru a nahrání datových souborů

Před přidáním souborů do datového registru je nutné je nahrát do kontejneru ve svém účtu úložiště Azure. Kontejnery se podobají adresáři v systému souborů. Jedná se o způsob uspořádání souborů v účtu úložiště Azure.

Pokud chcete vytvořit kontejner na webu Azure Portal, postupujte takto:

V rámci účtu úložiště Azure vyberte v navigačním podokně kontejnery v části Úložiště dat.
Výběrem +Kontejner v podokně Kontejnery otevřete podokno Nový kontejner .
Výběrem možnosti Vytvořit vytvořte kontejner.

Po vytvoření kontejneru do něj můžete nahrát soubory.
Po vytvoření kontejneru ho vyberte.
Vyberte Nahrát z panelu nástrojů, vyberte jeden nebo více souborů.
vyberte tlačítko Nahrát.

Přidání úložiště dat

Jakmile vytvoříte účet úložiště Azure se soubory nahranými do jednoho nebo více kontejnerů, můžete vytvořit úložiště dat, které propojí účty úložiště s vaším účtem Azure Maps.

Důležité

Všechny účty úložiště propojené s účtem Azure Maps musí být ve stejném zeměpisném umístění. Další informace najdete v geografickém rozsahu služby Azure Maps.

Poznámka:

Pokud účet úložiště nemáte, přečtěte si článek Vytvoření účtu úložiště.

V levé nabídce v účtu Azure Maps vyberte úložiště dat.
Vyberte tlačítko Přidat. Na pravé straně se zobrazí obrazovka Přidat úložiště dat.
Zadejte požadované ID úložiště dat a v rozevíracích seznamech vyberte název předplatného a účet úložiště.
Vyberte Přidat.

Nové úložiště dat se teď zobrazí v seznamu úložišť dat.

Přiřazení rolí spravovaným identitám a jejich přidání do úložiště dat

Po vytvoření spravovaných identit a úložiště dat můžete do úložiště dat přidat spravované identity a současně jim přiřadit role Přispěvatel a Čtenář dat objektů blob služby Storage. I když je možné přidat role do spravovaných identit přímo ve spravovaných identitách nebo účtu úložiště, které můžete snadno přidružovat k úložišti dat Azure Maps přímo v podokně úložiště dat.

Poznámka:

Každá spravovaná identita přidružená k úložišti dat bude potřebovat role Přispěvatel a Čtenář dat objektů blob služby Storage udělené jim. Pokud nemáte požadovaná oprávnění k udělení rolí spravovaným identitám, obraťte se na správce Azure. Přiřazení rolí spravovaným identitám a jejich přidružení k úložišti dat:

V levé nabídce v účtu Azure Maps vyberte úložiště dat.
Ze seznamu vyberte jeden nebo více úložišť dat a pak přiřaďte role.
V rozevíracím seznamu vyberte spravovanou identitu, kterou chcete přidružit k vybraným úložištím dat.
Pokud chcete přiřadit rozevírací seznam, vyberte čtenář dat přispěvatele i objektu blob úložiště v rolích.
Vyberte tlačítko Přiřadit.

Vlastnosti registru dat

S úložištěm dat vytvořeným ve vašem účtu Azure Maps jste připraveni shromáždit vlastnosti potřebné k vytvoření registru dat.

Existují vlastnosti AzureBlob, které předáte textu požadavku HTTP a ID uživatelských dat předané v adrese URL.

The AzureBlob

Jedná se AzureBlob o objekt JSON, který definuje vlastnosti potřebné k vytvoření registru dat.

Vlastnost	Popis
`kind`	Definuje, jaký typ objektu se registruje. V současné době je AzureBlob jediným podporovaným druhem.
`dataFormat`	Formát dat souboru umístěného v objektu blobUrl. Jeho formát může být GeoJSON pro prostorovou službu (zastaralé¹) nebo ZIP pro službu převodu (zastaralé¹).
`msiClientId`	ID spravované identity, která se používá k vytvoření registru dat.
`linkedResource`	ID úložiště dat zaregistrovaného v účtu Azure Maps. Úložiště dat obsahuje odkaz na zaregistrovaný soubor.
`blobUrl`	Adresa URL odkazující na umístění AzurebBlobu, soubor importovaný do kontejneru.

¹ Azure Maps Creator a registr dat a prostorové služby jsou nyní zastaralé a budou vyřazeny 30. 9. 25.

Následující dvě části obsahují podrobnosti o tom, jak získat hodnoty, které se mají použít pro msiClientId, vlastnosti blobUrl .

Vlastnost msiClientId

Vlastnost msiClientId je ID spravované identity použité k vytvoření registru dat. Existují dva typy spravovaných identit: přiřazené systémem a přiřazené uživatelem. Spravované identity přiřazené systémem mají svůj životní cyklus svázaný s prostředkem, který je vytvořil. Spravované identity přiřazené uživatelem je možné použít u více prostředků. Další informace najdete v tématu spravované identity pro prostředky Azure.

přiřazené systémem
přiřazené uživatelem

Při použití spravovaných identit přiřazených systémem nemusíte zadávat hodnotu vlastnosti msiClientId . Služba registru dat automaticky používá identitu přiřazenou systémem účtu Azure Maps, pokud msiClientId má hodnotu null.

Vlastnost blobUrl

Vlastnost blobUrl je cesta k registrovanému souboru. Tuto hodnotu můžete získat z kontejneru, do kterého byla přidána. registr dat

Na webu Azure Portal vyberte svůj účet úložiště.
V nabídce vlevo vyberte Kontejnery .
Zobrazí se seznam kontejnerů. Vyberte kontejner obsahující soubor, který chcete zaregistrovat.
Otevře se kontejner se seznamem dříve nahraných souborů.
Vyberte požadovaný soubor a zkopírujte adresu URL.

ID dat uživatele

ID uživatelských dat (udid) registru dat je identifikátor GUID definovaný uživatelem, který musí odpovídat následujícímu vzoru Regex:

^[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}$

Tip

Jedná se udid o uživatelem definovaný identifikátor GUID, který se musí zadat při vytváření registru dat. Pokud chcete mít jistotu, že máte globálně jedinečný identifikátor (GUID), zvažte jeho vytvoření spuštěním nástroje pro generování guid, jako je program příkazového řádku Guidgen.exe (k dispozici v sadě Visual Studio).

Vytvoření datového registru

Teď, když máte účet úložiště s požadovanými soubory propojenými s vaším účtem Azure Maps prostřednictvím úložiště dat a shromáždili jste všechny požadované vlastnosti, jste připraveni k registraci těchto souborů použít rozhraní API registru dat. Pokud máte ve svém účtu úložiště Azure více souborů, které chcete zaregistrovat, musíte spustit žádost o registraci pro každý soubor (udid).

Poznámka:

Maximální velikost souboru, který lze zaregistrovat v úložišti dat Azure Maps, je jedna gigabajt.

Vytvoření datového registru:

přiřazené systémem
přiřazené uživatelem

Zadejte informace potřebné k odkazování na účet úložiště, který se přidává do registru dat v textu požadavku HTTP. Informace musí být ve formátu JSON a musí obsahovat následující pole:
```
{
"kind": "AzureBlob",
    "azureBlob": {
        "dataFormat": "geojson",
        "linkedResource": "{datastore ID}",
        "blobUrl": "https://teststorageaccount.blob.core.windows.net/testcontainer/test.geojson"
    }
}
```
Poznámka:

Pokud používáte spravované identity přiřazené systémem, zobrazí se chyba, pokud do požadavku HTTP zadáte hodnotu vlastnosti msiClientId.

Další informace o vlastnostech požadovaných v textu požadavku HTTP naleznete v tématu Vlastnosti registru dat.
Jakmile budete mít připravený text požadavku HTTP, spusťte následující požadavek HTTP PUT:
```
https://us.atlas.microsoft.com/dataRegistries/{udid}?api-version=2023-06-01&subscription-key={Your-Azure-Maps-Subscription-key} 
```
Další informace o udid vlastnosti naleznete v tématu ID dat uživatele.
Zkopírujte hodnotu klíče operation-location z hlavičky odpovědi.

Zadejte informace potřebné k odkazování na účet úložiště, který se přidává do registru dat v textu požadavku HTTP. Informace musí být ve formátu JSON a musí obsahovat následující pole:
```
{
"kind": "AzureBlob",
    "azureBlob": {
        "dataFormat": "geojson",
        "msiClientId": "{The client ID of the managed identity}",
        "linkedResource": "{datastore ID}",
        "blobUrl": "https://teststorageaccount.blob.core.windows.net/testcontainer/test.geojson"
    }
}
```
Poznámka:

Při použití spravovaných identit přiřazených uživatelem se v požadavku HTTP zobrazí chyba, pokud v požadavku HTTP nezadáte hodnotu vlastnosti msiClientId.

Další informace o vlastnostech požadovaných v textu požadavku HTTP naleznete v tématu Vlastnosti registru dat.
Jakmile budete mít připravený text požadavku HTTP, spusťte následující požadavek HTTP PUT:
```
https://us.atlas.microsoft.com/dataRegistries/{udid}?api-version=2023-06-01&subscription-key={Your-Azure-Maps-Subscription-key} 
```
Další informace o udid vlastnosti naleznete v tématu ID dat uživatele.
Zkopírujte hodnotu klíče operation-location z hlavičky odpovědi.

Tip

Pokud se obsah dříve registrovaného souboru změní, ověření dat se nezdaří a nebude možné ho použít v Azure Maps, dokud se znovu nezaregistruje. Pokud chcete znovu zaregistrovat soubor, spusťte znovu žádost o registraci a předáte stejnou službu AzureBlob , která se použila k vytvoření původní registrace. Hodnota klíče operation-location je adresa URL stavu, kterou použijete ke kontrole stavu vytvoření registru dat v další části, obsahuje ID operace používané rozhraním API operace Get.

Poznámka:

Hodnota klíče operation-location nebude obsahovat subscription-key, budete muset přidat tuto adresu URL požadavku při použití ke kontrole stavu vytvoření registru dat.

Kontrola stavu vytvoření datového registru

Pokud chcete (volitelně) zkontrolovat stav procesu vytváření registru dat, zadejte adresu URL stavu, kterou jste zkopírovali v části Vytvořit registr dat, a přidejte klíč předplatného jako parametr řetězce dotazu. Požadavek by měl vypadat podobně jako následující adresa URL:

https://us.atlas.microsoft.com/dataRegistries/operations/{udid}?api-version=2023-06-01&subscription-key={Your-Azure-Maps-Primary-Subscription-key}

Získání seznamu všech souborů v datovém registru

Pomocí požadavku Seznam získáte seznam všech souborů zaregistrovaných v účtu Azure Maps:

https://us.atlas.microsoft.com/dataRegistries?api-version=2023-06-01&subscription-key={Azure-Maps-Subscription-key}

Následující ukázka ukazuje tři možné stavy, dokončené, spuštěné a neúspěšné:

{
  "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==."
      }
    }
  ]
}

Data vrácená při spuštění žádosti o seznam se podobaují datům zadaným při vytváření registru s několika dalšími funkcemi:

vlastnost	description
contentMD5	Hodnota hash MD5 vytvořená z obsahu zaregistrovaného souboru Další informace najdete v tématu Ověření dat.
sizeInBytes	Velikost obsahu vbajchch

Nahrazení datového registru

Pokud potřebujete nahradit dříve zaregistrovaný soubor jiným souborem, spusťte znovu žádost o registraci a předejte stejnou položku AzureBlob , která se použila k vytvoření původní registrace s výjimkou objektu blobUrl. Je BlobUrl potřeba upravit tak, aby odkazovaly na nový soubor.

Ověření dat

Když v Azure Maps zaregistrujete soubor pomocí rozhraní API pro registr dat, vytvoří se hodnota hash MD5 z obsahu souboru, zakóduje ho na 128bitový otisk prstu a uloží ho jako AzureBlob contentMD5 vlastnost. Hodnota hash MD5 uložená ve contentMD5 vlastnosti se používá k zajištění integrity dat souboru. Vzhledem k tomu, že algoritmus hash MD5 vždy vytváří stejný výstup vzhledem ke stejnému vstupu, proces ověření dat může porovnat contentMD5 vlastnost souboru při registraci proti hodnotě hash souboru v účtu úložiště Azure a zkontrolovat, že je nedotčená a neupravená. Pokud hodnota hash není stejná, ověření selže. Pokud se soubor v podkladovém účtu úložiště změní, ověření se nezdaří. Pokud potřebujete upravit obsah souboru, který je zaregistrovaný v Azure Maps, musíte ho znovu zaregistrovat.

Sdílet prostřednictvím

Jak vytvořit registr dat

Požadavky

Příprava na registraci dat v Azure Maps

Vytváření spravovaných identit

Vytvoření kontejneru a nahrání datových souborů

Přidání úložiště dat

Přiřazení rolí spravovaným identitám a jejich přidání do úložiště dat

Vlastnosti registru dat

The AzureBlob

Vlastnost msiClientId

Vlastnost blobUrl

ID dat uživatele

Vytvoření datového registru

Kontrola stavu vytvoření datového registru

Získání seznamu všech souborů v datovém registru

Nahrazení datového registru

Ověření dat

Váš názor

Další materiály