Az adatait áttelepítheti egy Azure Cosmos DB Table API-fiókba

A következőkre vonatkozik: Table API

Ez az oktatóanyag útmutatást nyújt az adatimportáláshoz a Azure Cosmos DB Table APIvaló használatra. Ha az Azure Table Storageban tárolt adatai vannak, akkor az adatáttelepítés eszközzel vagy a AzCopy importálhatja az adatait a Azure Cosmos DB Table APIba.

Ez az oktatóanyag a következő feladatokat mutatja be:

  • Adatimportálás az adatáttelepítési eszközzel
  • Adatok importálása az AzCopy használatával

Előfeltételek

  • Átviteli sebesség növelése: Az adatok áttelepítésének időtartama az egyes tárolók vagy tárolók készlete számára beállított átviteli sebességtől függ. Nagyobb adatmigrálásoknál mindenképpen növelje az átviteli sebességet. A migrálás befejezése után, a költségtakarékosság érdekében csökkentse az átviteli sebességet.

  • Azure Cosmos db erőforrások létrehozása: Az adatok áttelepítésének megkezdése előtt hozza létre az összes táblát a Azure Portal. Ha olyan Azure Cosmos DB-fiókra végez áttelepítést, amelynek adatbázis-szintű átviteli sebessége van, akkor a Azure Cosmos DB táblák létrehozásakor ügyeljen arra, hogy adjon meg egy partíciós kulcsot.

Adatáttelepítési eszköz

A Azure Cosmos DB parancssori adatáttelepítési eszköz (dt.exe) segítségével importálhatja meglévő Azure-Table Storage-adatait egy Table API-fiókba.

A Table-adatáttelepítés:

  1. Töltse le a migrálási eszközt a GitHubról.

  2. Futtassa dt.exe a parancsot a forgatókönyvhöz tartozó parancssori argumentumok használatával. A dt.exe a következő formátumban fogad el parancsokat:

     dt.exe [/<option>:<value>] /s:<source-name> [/s.<source-option>:<value>] /t:<target-name> [/t.<target-option>:<value>] 
    

A parancs támogatott beállításai a következők:

  • /ErrorLog: Választható. Az adatátviteli hibák átirányítására szolgáló CSV-fájl neve.
  • /OverwriteErrorLog: Választható. Írja felül a hibanapló fájlját.
  • /ProgressUpdateInterval: Nem kötelező, alapértelmezett érték: 00:00:01 . A képernyőn megjelenő adatátviteli folyamat frissítésének időintervalluma.
  • /ErrorDetails: Nem kötelező, alapértelmezett érték: None . Megadja, hogy a rendszer részletes információkat jelenít meg a következő hibákhoz: None , Critical , vagy All .
  • /EnableCosmosTableLog: Választható. Irányítsa a naplót egy Azure Cosmos DB Table-fiókba. Ha be van állítva, ez alapértelmezés szerint a cél fiók kapcsolódási karakterláncát adja meg, kivéve, ha /CosmosTableLogConnectionString az meg van határozva. Ez akkor hasznos, ha az eszköz több példánya egyidejűleg fut.
  • /CosmosTableLogConnectionString: Választható. A kapcsolódási karakterlánc, amely a naplót egy távoli Azure Cosmos DB Table-fiókba irányítja.

Parancssori forrásbeállítások

Ha az áttelepítés forrásaként az Azure Table Storaget adja meg, használja az alábbi forrás beállításokat.

  • /s: AzureTable: Adatokat olvas Table Storageból.
  • /s.ConnectionString: A tábla végpontjának a kapcsolatok karakterlánca. Ezt a Azure Portal kérheti le.
  • /s.LocationMode: Nem kötelező, alapértelmezett érték: PrimaryOnly . Meghatározza, hogy a Table Storagehoz való csatlakozáskor melyik hely módot kell használni:,, PrimaryOnly PrimaryThenSecondary SecondaryOnly , SecondaryThenPrimary .
  • /s.table: Az Azure-tábla neve.
  • /s.InternalFields: A All tábla áttelepítésére van beállítva, mert az RowKey PartitionKey importáláshoz szükséges.
  • /s.Filter: Választható. Az alkalmazni kívánt karakterlánc szűrése.
  • /s.Projection: Választható. A kijelölni kívánt oszlopok listája

A forrás-kapcsolódási karakterlánc lekéréséhez Table Storageból való importáláskor nyissa meg a Azure Portal. Válassza ki a Storage > -fiók > hozzáférési kulcsait, és másolja a kapcsolati karakterláncot.

Képernyőfelvétel: a Storage-fiókok > fiók > hozzáférési kulcsok beállításai, és kiemeli a másolási ikont.

Parancssori célbeállítások

Ha a Azure Cosmos DB Table API az áttelepítés céljaként adja meg, akkor használja a következő célzási beállításokat.

  • /t: TableAPIBulk: Adatok feltöltése a Azure Cosmos DB Table API kötegekben.
  • /t.ConnectionString: A tábla végpontjának a kapcsolatok karakterlánca.
  • /t.TableName: Megadja az írni kívánt tábla nevét.
  • /t.overwrite: Nem kötelező, alapértelmezett érték: false . Meghatározza, hogy a meglévő értékeket felül kell-e írni.
  • /t.MaxInputBufferSize: Nem kötelező, alapértelmezett érték: 1GB . Az adatok fogadóba való kiürítése előtt a pufferben lévő bemeneti bájtok becsült becslése.
  • /t.throughput: Nem kötelező, a szolgáltatás alapértelmezett értéke, ha nincs megadva. Meghatározza a tábla konfigurálásának sebességét.
  • /t.MaxBatchSize: Nem kötelező, alapértelmezett érték: 2MB . A köteg méretét bájtban kell megadni.

Minta parancs: a forrás Table Storage

Az alábbi parancssori minta azt mutatja be, hogyan lehet importálni a Table Storageból a Table APIba:

dt /s:AzureTable /s.ConnectionString:DefaultEndpointsProtocol=https;AccountName=<Azure Table storage account name>;AccountKey=<Account Key>;EndpointSuffix=core.windows.net /s.Table:<Table name> /t:TableAPIBulk /t.ConnectionString:DefaultEndpointsProtocol=https;AccountName=<Azure Cosmos DB account name>;AccountKey=<Azure Cosmos DB account key>;TableEndpoint=https://<Account name>.table.cosmosdb.azure.com:443 /t.TableName:<Table name> /t.Overwrite

Adatok migrálása az AzCopy használatával

A AzCopy parancssori segédprogrammal az adatok áttelepíthetők a Table Storageról a Azure Cosmos DB Table API. A AzCopy használatához először exportálja az adatait az adatok exportálása Table Storagebólcímű témakörben leírtak szerint. Ezt követően importálja az Azure Cosmos DB az Azure Cosmos DB Table APIcímű témakörben leírtak szerint.

Az Azure Cosmos DBba való importáláskor tekintse meg a következő mintát. Vegye figyelembe, hogy az érték a ( /Dest cosmosdb nem) értéket használja core .

Importálási példaparancs:

AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.table.cosmosdb.windows.net/mytable1/ /DestKey:key /Manifest:"myaccount_mytable_20140103T112020.manifest" /EntityOperation:InsertOrReplace

Következő lépések

Megtudhatja, hogyan kérdezheti le az információkat a Azure Cosmos DB Table API használatával.