Migrera data till Azure Cosmos DB Table-API-kontoMigrate your data to Azure Cosmos DB Table API account

GÄLLER för: tabell-API

Den här självstudien innehåller instruktioner om hur du importerar data för användning med Azure Cosmos DB tabell-API.This tutorial provides instructions on importing data for use with the Azure Cosmos DB Table API. Om du har lagrade data i Azure Table Storage kan du använda datamigreringsverktyget eller AzCopy för att importera dina data till Azure Cosmos DB Table-API:t.If you have data stored in Azure Table storage, you can use either the Data Migration Tool or AzCopy to import your data to Azure Cosmos DB Table API. Om du har data som lagras i ett Azure Cosmos DB Table API-konto (förhandsversion) måste du använda datamigreringsverktyget för att migrera data.If you have data stored in an Azure Cosmos DB Table API (preview) account, you must use the Data Migration tool to migrate your data.

Den här självstudien omfattar följande uppgifter:This tutorial covers the following tasks:

  • Importera data med datamigreringsverktygetImporting data with the Data Migration tool
  • Importera data med AzCopyImporting data with AzCopy
  • Migrera från Table API (förhandsversion) till Table APIMigrating from Table API (preview) to Table API

FörutsättningarPrerequisites

  • Öka data flödet: Varaktigheten för din datamigrering beror på mängden data flöde som du har konfigurerat för en enskild behållare eller en uppsättning behållare.Increase throughput: The duration of your data migration depends on the amount of throughput you set up for an individual container or a set of containers. Vi rekommenderar att du ökar dataflödet för större datamigreringar.Be sure to increase the throughput for larger data migrations. När du har slutfört migreringen minskar du dataflödet för att spara kostnader.After you've completed the migration, decrease the throughput to save costs. Mer information om hur du ökar dataflödet i Azure Portal finns i avsnittet om prestandanivåer och prisnivåer i Azure Cosmos DB.For more information about increasing throughput in the Azure portal, see Performance levels and pricing tiers in Azure Cosmos DB.

  • Skapa Azure Cosmos DB-resurser: Innan du börjar migrera data skapar du alla dina tabeller i förväg från Azure-portalen.Create Azure Cosmos DB resources: Before you start the migrating data, pre-create all your tables from the Azure portal. Om du migrerar till ett Azure Cosmos DB-konto som har dataflöde på databasnivå anger du en partitionsnyckel när du skapar Azure Cosmos DB-tabellerna.If you are migrating to an Azure Cosmos DB account that has database level throughput, make sure to provide a partition key when creating the Azure Cosmos DB tables.

DatamigreringsverktygetData Migration tool

Du kan använda det kommandoradsbaserade datamigreringsverktyget för Azure Cosmos DB (dt.exe) för att importera befintliga Azure Table Storage-data till ett Table API GA-konto, eller för att migrera data från ett Table API-konto (förhandsversion) till ett Table API GA-konto.The command-line Azure Cosmos DB Data Migration tool (dt.exe) can be used to import your existing Azure Table storage data to a Table API GA account, or migrate data from a Table API (preview) account into a Table API GA account. Andra källor stöds inte för närvarande.Other sources are not currently supported. Det går för närvarande inte att använda det användargränssnittsbaserade datamigreringsverktyget (dtui.exe) med Table API-konton.The UI based Data Migration tool (dtui.exe) is not currently supported for Table API accounts.

Utför följande åtgärder om du vill migrera tabelldata:To perform a migration of table data, complete the following tasks:

  1. Ladda ned migreringsverktyget från GitHub.Download the migration tool from GitHub.

  2. Kör dt.exe med kommandoradsargumenten för ditt scenario.Run dt.exe using the command-line arguments for your scenario. dt.exe stöder kommandon i följande format:dt.exe takes a command in the following format:

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

Alternativen som stöds för det här kommandot är:The supported options for this command are:

  • /Errorlog: Valfritt./ErrorLog: Optional. Namnet på CSV-filen för att dirigera om data överförings problemName of the CSV file to redirect data transfer failures
  • /OverwriteErrorLog: Valfritt./OverwriteErrorLog: Optional. Skriv över fel logg filenOverwrite error log file
  • /ProgressUpdateInterval: Valfritt, standard är 00:00:01./ProgressUpdateInterval: Optional, default is 00:00:01. Tidsintervall för uppdatering av data överförings förlopp på skärmenTime interval to refresh on-screen data transfer progress
  • /ErrorDetails: Valfritt, standard är ingen./ErrorDetails: Optional, default is None. Anger att detaljerad fel information ska visas för följande fel: ingen, kritiskt, allaSpecifies that detailed error information should be displayed for the following errors: None, Critical, All
  • /EnableCosmosTableLog: Valfritt./EnableCosmosTableLog: Optional. Dirigera loggen till ett Cosmos-tabell konto.Direct the log to a cosmos table account. Om det här alternativet är inställt, är detta standardvärdet för anslutnings strängen för mål kontot om inte/CosmosTableLogConnectionString ocksåIf set, this defaults to destination account connection string unless /CosmosTableLogConnectionString is also provided. Detta är användbart om flera instanser av DT körs samtidigt.This is useful if multiple instances of DT are being run simultaneously.
  • /CosmosTableLogConnectionString: Valfritt./CosmosTableLogConnectionString: Optional. ConnectionString för att dirigera loggen till ett fjärran sluten Cosmos-tabell konto.ConnectionString to direct the log to a remote cosmos table account.

Kommandoradsinställningar för källanCommand-line source settings

Använd följande alternativ för källan när du definierar Azure Table Storage eller Table API (förhandsversion) som källan för migreringen.Use the following source options when defining Azure Table Storage or Table API preview as the source of the migration.

  • /s: AzureTable: Läser data från Azure Table Storage/s:AzureTable: Reads data from Azure Table storage
  • /s.ConnectionString: Anslutnings sträng för tabell slut punkten./s.ConnectionString: Connection string for the table endpoint. Detta kan hämtas från Azure PortalThis can be retrieved from the Azure portal
  • /s.LocationMode: Valfritt, standard är PrimaryOnly./s.LocationMode: Optional, default is PrimaryOnly. Anger vilket plats läge som ska användas vid anslutning till Azure Table Storage: PrimaryOnly, PrimaryThenSecondary, SecondaryOnly, SecondaryThenPrimarySpecifies which location mode to use when connecting to Azure Table storage: PrimaryOnly, PrimaryThenSecondary, SecondaryOnly, SecondaryThenPrimary
  • /s.table: Namn på Azure-tabellen/s.Table: Name of the Azure Table
  • /s.InternalFields: Ange som RowKey och PartitionKey krävs för att importera./s.InternalFields: Set to All for table migration as RowKey and PartitionKey are required for import.
  • /s.filter: Valfritt./s.Filter: Optional. Filter sträng som ska användasFilter string to apply
  • /s.Projection: Valfritt./s.Projection: Optional. Lista med kolumner som ska väljasList of columns to select

Om du vill hämta käll anslutnings strängen när du importerar från Azure Table Storage öppnar du Azure Portal och klickar på lagrings konton > konto > åtkomst nycklar och använder sedan kopierings knappen för att kopiera anslutnings strängen .To retrieve the source connection string when importing from Azure Table storage, open the Azure portal and click Storage accounts > Account > Access keys , and then use the copy button to copy the Connection string .

Skärm bild som visar alternativ för lagrings konton > konto > åtkomst nycklar och markerar knappen Kopiera.

Om du vill hämta käll anslutnings strängen när du importerar från ett Azure Cosmos DB tabell-API (förhands granskning), öppnar du Azure Portal, klickar på Azure Cosmos DB > kontots > anslutnings sträng och använder kopierings knappen för att kopiera anslutnings strängen .To retrieve the source connection string when importing from an Azure Cosmos DB Table API (preview) account, open the Azure portal, click Azure Cosmos DB > Account > Connection String and use the copy button to copy the Connection String .

Skärmbild över alternativ för HBase-källor

Azure Table Storage-exempelkommandoSample Azure Table Storage command

Azure Cosmos DB Table API-exempelkommando (förhandsversion)Sample Azure Cosmos DB Table API (preview) command

Kommandoradsinställningar för måletCommand-line target settings

Använd följande alternativ för målet när du definierar Azure Cosmos DB Table-API:et som målet för migreringen.Use the following target options when defining Azure Cosmos DB Table API as the target of the migration.

  • /t: TableAPIBulk: Överför data till Azure dataCosmosDBs-tabellen i batchar/t:TableAPIBulk: Uploads data into Azure CosmosDB Table in batches
  • /t.ConnectionString: Anslutnings sträng för tabell slut punkten/t.ConnectionString: Connection string for the table endpoint
  • /t.TableName: Anger namnet på den tabell som ska skrivas till/t.TableName: Specifies the name of the table to write to
  • /t.overwrite: Valfritt, standardvärdet är false./t.Overwrite: Optional, default is false. Anger om befintliga värden ska skrivas överSpecifies if existing values should be overwritten
  • /t.MaxInputBufferSize: Valfritt är standard 1 GB./t.MaxInputBufferSize: Optional, default is 1GB. Ungefärlig uppskattning av inkommande byte till buffert innan data töms till SinkApproximate estimate of input bytes to buffer before flushing data to sink
  • /t.Throughput: Valfritt, service standardinställningar om inget anges./t.Throughput: Optional, service defaults if not specified. Anger data flöde som ska konfigureras för tabellenSpecifies throughput to configure for table
  • /t.MaxBatchSize: Valfritt, standard är 2 MB./t.MaxBatchSize: Optional, default is 2MB. Ange batchstorleken i byteSpecify the batch size in bytes

Exempelkommando: Källan är Azure Table StorageSample command: Source is Azure Table storage

Här är ett kommandoradsexempel som visar hur du importerar från Azure Table Storage till Table API:Here is a command-line sample showing how to import from Azure Table storage to Table API:

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

Exempelkommando: Källan är Azure Cosmos DB Table API (förhandsversion)Sample command: Source is Azure Cosmos DB Table API (preview)

Här är ett kommandoradsexempel som visar hur du importerar från Table API (förhandsversion) till Table API GA:Here is a command-line sample to import from Table API preview to Table API GA:

dt /s:AzureTable /s.ConnectionString:DefaultEndpointsProtocol=https;AccountName=<Table API preview account name>;AccountKey=<Table API preview account key>;TableEndpoint=https://<Account Name>.documents.azure.com; /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

Migrera data med AzCopyMigrate data by using AzCopy

Det andra alternativet som du kan använda när du migrerar data från Azure Table Storage till Azure Cosmos DB Table API är kommandoradsverktyget AzCopy.Using the AzCopy command-line utility is the other option for migrating data from Azure Table storage to the Azure Cosmos DB Table API. Om du vill använda AzCopy börjar du med att exportera dina data genom att följa anvisningarna i Exportera data från Table Storage och importerar dem sedan till Azure Cosmos DB genom att följa anvisningarna i Azure Cosmos DB Table API.To use AzCopy, you first export your data as described in Export data from Table storage, then import the data to Azure Cosmos DB as described in Azure Cosmos DB Table API.

Använd följande exempel som referens när du importerar till Azure Cosmos DB.When performing the import into Azure Cosmos DB, refer to the following sample. Observera att /Dest-värdet använder cosmosdb, inte core.Note that the /Dest value uses cosmosdb, not core.

Exempel på importkommando:Example import command:

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

Migrera från Table API (förhandsversion) till Table APIMigrate from Table API (preview) to Table API

Varning

Om du genast vill dra nytta av fördelarna med allmänt tillgängliga tabeller i GA-versionen migrerar du dina befintliga tabeller i förhandsversionen genom att följa anvisningarna i det här avsnittet. Annars kommer vi att genomföra en automatisk migrering av befintliga kunder med förhandsversionen under de kommande veckorna. Observera att tabeller i förhandsversionen har vissa begränsningar som nyligen skapade tabeller inte har.If you want to immediately enjoy the benefits of the generally available tables then please migrate your existing preview tables as specified in this section, otherwise we will be performing auto-migrations for existing preview customers in the coming weeks, note however that auto-migrated preview tables will have certain restrictions to them that newly created tables will not.

Nu är Table API allmänt tillgängligt (GA).The Table API is now generally available (GA). Det finns skillnader mellan förhandsversionen och GA-versionen för tabeller både i koden som körs i molnet och i koden som körs på klienten.There are differences between the preview and GA versions of tables both in the code that runs in the cloud as well as in code that runs at the client. Därför avråder vi dig från att försöka kombinera en SDK-klient som använder förhandsversionen med ett Table API-konto i GA-versionen och tvärtom.Therefore it is not advised to try to mix a preview SDK client with a GA Table API account, and vice versa. Kunder med förhandsversionen av Table API som vill fortsätta att använda sina befintliga tabeller men i en produktionsmiljö, måste migrera från förhandsversionen till GA-miljön eller vänta på den automatiska migreringen.Table API preview customers who want to continue to use their existing tables but in a production environment need to migrate from the preview to the GA environment, or wait for auto-migration. Om du väljer att skjuta upp migreringen till den automatiska migreringen kommer du att informeras om begränsningarna i migrerade tabeller.If you wait for auto-migration, you will be notified of the restrictions on the migrated tables. Efter migreringen kommer du att kunna skapa nya tabeller i ditt befintliga konto utan begränsningar (endast migrerade tabeller har begränsningar).After migration, you will be able to create new tables on your existing account without restrictions (only migrated tables will have restrictions).

Så här migrerar du från förhandsversionen av Table API till GA-versionen:To migrate from Table API (preview) to the generally available Table API:

  1. Skapa ett nytt Azure Cosmos DB-konto och ange kontots API-typ till Azure Table genom att följa anvisningarna i Skapa ett databaskonto.Create a new Azure Cosmos DB account and set its API type to Azure Table as described in Create a database account.

  2. Ändra klienterna så att de använder en GA-version (allmänt tillgänglig) av Table API-SDK:erna.Change clients to use a GA release of the Table API SDKs.

  3. Migrera klientdata från tabeller i förhandsversionen till GA-tabeller med hjälp av datamigreringsverktyget.Migrate the client data from preview tables to GA tables by using the Data Migration tool. Anvisningar för hur du använder datamigreringsverktyget i detta syfte beskrivs i avsnittet om datamigreringsverktyget.Instructions on using the data migration tool for this purpose are described in Data Migration tool.

Nästa stegNext steps

I den här självstudiekursen lärde du dig att:In this tutorial you learned how to:

  • Importera data med datamigreringsverktygetImport data with the Data Migration tool
  • Importera data med AzCopyImport data with AzCopy
  • Migrera från Table API (förhandsversion) till Table APIMigrate from Table API (preview) to Table API

Nu kan du fortsätta med nästa självstudiekurs där du lär dig hur du kör frågor mot data med hjälp av Azure Cosmos DB Table-API:et.You can now proceed to the next tutorial and learn how to query data using the Azure Cosmos DB Table API.