Självstudie: Använda datamigreringsverktyget för att migrera data till Azure Cosmos DBTutorial: Use Data migration tool to migrate your data to Azure Cosmos DB

GÄLLER för: SQL API

Den här självstudien innehåller anvisningar för hur du använder datamigreringsverktyget i Azure Cosmos DB, som kan importera data från olika källor till containrar och tabeller i Azure Cosmos DB.This tutorial provides instructions on using the Azure Cosmos DB Data Migration tool, which can import data from various sources into Azure Cosmos containers and tables. Du kan importera från JSON-filer, CSV-filer, SQL, MongoDB, Azure Table Storage, Amazon DynamoDB och till och med Azure Cosmos DB SQL API-samlingar.You can import from JSON files, CSV files, SQL, MongoDB, Azure Table storage, Amazon DynamoDB, and even Azure Cosmos DB SQL API collections. Du migrerar dessa data till samlingar och tabeller för användning med Azure Cosmos DB.You migrate that data to collections and tables for use with Azure Cosmos DB. Datamigreringsverktyget kan också användas när du migrerar från en enda partitionssamling till en samling med flera partitioner för SQL API.The Data Migration tool can also be used when migrating from a single partition collection to a multi-partition collection for the SQL API.

Anteckning

Verktyget Azure Cosmos DB datamigrering är ett verktyg för öppen källkod som har utformats för små migreringar.The Azure Cosmos DB Data Migration tool is an open source tool designed for small migrations. För större migreringar, se vår Guide för attmata in data.For larger migrations, view our guide for ingesting data.

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

  • Installera datamigreringsverktygetInstalling the Data Migration tool
  • Importera data från olika datakällorImporting data from different data sources
  • Exportera från Azure Cosmos DB till JSONExporting from Azure Cosmos DB to JSON

FörutsättningarPrerequisites

Innan du följer anvisningarna i den här artikeln bör du se till att du utför följande steg:Before following the instructions in this article, ensure that you do the following steps:

  • Installera Microsoft .NET Framework 4.51 eller högre.Install Microsoft .NET Framework 4.51 or higher.

  • Öka dataflödet : Hur lång tid datamigreringen tar beror på hur stort dataflöde du anger för en enskild samling eller en uppsättning samlingar.Increase throughput: The duration of your data migration depends on the amount of throughput you set up for an individual collection or a set of collections. 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-portalen finns i avsnitten 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 samlingar i förväg från Azure-portalen.Create Azure Cosmos DB resources: Before you start the migrating data, pre-create all your collections from the Azure portal. Om du vill migrera till ett Azure Cosmos DB konto som har data flöde på databas nivå, anger du en partitionsnyckel när du skapar Azure Cosmos-behållare.To migrate to an Azure Cosmos DB account that has database level throughput, provide a partition key when you create the Azure Cosmos containers.

Viktigt

För att se till att verktyget datamigrering använder Transport Layer Security (TLS) 1,2 när du ansluter till dina Azure Cosmos-konton, använder du .NET Framework version 4,7 eller följer instruktionerna i den här artikeln.To make sure that the Data migration tool uses Transport Layer Security (TLS) 1.2 when connecting to your Azure Cosmos accounts, use the .NET Framework version 4.7 or follow the instructions found in this article.

ÖversiktOverview

Datamigreringsverktyget är en lösning med öppen källkod som importerar data till Azure Cosmos DB från olika källor, inklusive:The Data Migration tool is an open-source solution that imports data to Azure Cosmos DB from a variety of sources, including:

  • JSON-filerJSON files
  • MongoDBMongoDB
  • SQL ServerSQL Server
  • CSV-filerCSV files
  • Azure Table StorageAzure Table storage
  • Amazon DynamoDBAmazon DynamoDB
  • HBaseHBase
  • Azure Cosmos-containrarAzure Cosmos containers

Även om importverktyget innehåller ett grafiskt användargränssnitt (dtui.exe), kan det också köras från kommandoraden (dt.exe).While the import tool includes a graphical user interface (dtui.exe), it can also be driven from the command-line (dt.exe). Det finns faktiskt ett alternativ till att få utdata från ett associerat kommando när du har konfigurerat en import via användargränssnittet.In fact, there's an option to output the associated command after setting up an import through the UI. Du kan transformera tabellkälldata, till exempel SQL Server- eller CSV-filer, för att skapa hierarkiska relationer (underdokument) vid import.You can transform tabular source data, such as SQL Server or CSV files, to create hierarchical relationships (subdocuments) during import. Om du vill kan du läsa mer om källalternativ, exempelkommandon för att importera från varje källa, målalternativ och hur du ser de importerade resultaten.Keep reading to learn more about source options, sample commands to import from each source, target options, and viewing import results.

Anteckning

Du bör endast använda verktyget Azure Cosmos DB migrering för små migreringar.You should only use the Azure Cosmos DB migration tool for small migrations. För stora migreringar, se vår Guide för attmata in data.For large migrations, view our guide for ingesting data.

InstallationInstallation

Källkoden för migreringsverktyget finns i GitHub på den här lagringsplatsen.The migration tool source code is available on GitHub in this repository. Du kan ladda ned och kompilera lösningen lokalt, eller ladda ned en förkompilerad binär kod och sedan köra något av följande:You can download and compile the solution locally, or download a pre-compiled binary, then run either:

  • Dtui.exe : Grafisk gränssnittsversion av verktygetDtui.exe : Graphical interface version of the tool
  • DT.exe : Kommandoradsversion av verktygetDt.exe : Command-line version of the tool

Välj datakällaSelect data source

När du har installerat verktyget är det dags att importera dina data.Once you've installed the tool, it's time to import your data. Vilken typ av data vill du importera?What kind of data do you want to import?

Importera JSON-filerImport JSON files

Med importverktygets alternativ för JSON-filkällor kan du importera ett eller flera dokument med JSON-filer, eller flera JSON-filer som var och en har en matris med JSON-dokument.The JSON file source importer option allows you to import one or more single document JSON files or JSON files that each have an array of JSON documents. När du lägger till mappar som har JSON-filer som ska importeras har du möjlighet att rekursivt söka efter filerna i undermappar.When adding folders that have JSON files to import, you have the option of recursively searching for files in subfolders.

Skärmbild av alternativ för JSON-filkällor – Verktyg för databasmigrering

Anslutnings strängen har följande format:The connection string is in the following format:

AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>

  • <CosmosDB Endpoint>Är slut punktens URI.The <CosmosDB Endpoint> is the endpoint URI. Du kan hämta det här värdet från Azure Portal.You can get this value from the Azure portal. Navigera till ditt Azure Cosmos-konto.Navigate to your Azure Cosmos account. Öppna översikts fönstret och kopiera URI -värdet.Open the Overview pane and copy the URI value.
  • <AccountKey>Är "lösen ordet" eller primär nyckel.The <AccountKey> is the "Password" or PRIMARY KEY. Du kan hämta det här värdet från Azure Portal.You can get this value from the Azure portal. Navigera till ditt Azure Cosmos-konto.Navigate to your Azure Cosmos account. Öppna fönstret anslutnings strängar eller nycklar och kopiera värdet "lösen ord" eller primär nyckel .Open the Connection Strings or Keys pane, and copy the "Password" or PRIMARY KEY value.
  • <CosmosDB Database>Är namnet på CosmosDB-databasen.The <CosmosDB Database> is the CosmosDB database name.

Exempel: AccountEndpoint=https://myCosmosDBName.documents.azure.com:443/;AccountKey=wJmFRYna6ttQ79ATmrTMKql8vPri84QBiHTt6oinFkZRvoe7Vv81x9sn6zlVlBY10bEPMgGM982wfYXpWXWB9w==;Database=myDatabaseNameExample: AccountEndpoint=https://myCosmosDBName.documents.azure.com:443/;AccountKey=wJmFRYna6ttQ79ATmrTMKql8vPri84QBiHTt6oinFkZRvoe7Vv81x9sn6zlVlBY10bEPMgGM982wfYXpWXWB9w==;Database=myDatabaseName

Anteckning

Använd kommandot verifiera för att se till att det Cosmos DB konto som anges i fältet anslutnings sträng kan nås.Use the Verify command to ensure that the Cosmos DB account specified in the connection string field can be accessed.

Här följer några kommandoradsexempel för import av JSON-filer:Here are some command-line samples to import JSON files:

#Import a single JSON file
dt.exe /s:JsonFile /s.Files:.\Sessions.json /t:DocumentDBBulk /t.ConnectionString:"AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /t.Collection:Sessions /t.CollectionThroughput:2500

#Import a directory of JSON files
dt.exe /s:JsonFile /s.Files:C:\TESessions\*.json /t:DocumentDBBulk /t.ConnectionString:" AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /t.Collection:Sessions /t.CollectionThroughput:2500

#Import a directory (including sub-directories) of JSON files
dt.exe /s:JsonFile /s.Files:C:\LastFMMusic\**\*.json /t:DocumentDBBulk /t.ConnectionString:" AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /t.Collection:Music /t.CollectionThroughput:2500

#Import a directory (single), directory (recursive), and individual JSON files
dt.exe /s:JsonFile /s.Files:C:\Tweets\*.*;C:\LargeDocs\**\*.*;C:\TESessions\Session48172.json;C:\TESessions\Session48173.json;C:\TESessions\Session48174.json;C:\TESessions\Session48175.json;C:\TESessions\Session48177.json /t:DocumentDBBulk /t.ConnectionString:"AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /t.Collection:subs /t.CollectionThroughput:2500

#Import a single JSON file and partition the data across 4 collections
dt.exe /s:JsonFile /s.Files:D:\\CompanyData\\Companies.json /t:DocumentDBBulk /t.ConnectionString:"AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /t.Collection:comp[1-4] /t.PartitionKey:name /t.CollectionThroughput:2500

Importera från MongoDBImport from MongoDB

Viktigt

Om du importerar till ett Cosmos-konto som har konfigurerats med Azure Cosmos DB API för MongoDB, följer du dessa instruktioner.If you're importing to a Cosmos account configured with Azure Cosmos DB's API for MongoDB, follow these instructions.

Med importverktygets alternativ för MongoDB-källor kan du importera från en enskild MongoDB-samling, filtrera dokument med hjälp av en fråga (valfritt) och ändra dokumentstrukturen med hjälp av en projektion.With the MongoDB source importer option, you can import from a single MongoDB collection, optionally filter documents using a query, and modify the document structure by using a projection.

Skärmbild av MongoDB-källalternativ

Anslutningssträngen är i standardformatet för MongoDB:The connection string is in the standard MongoDB format:

mongodb://<dbuser>:<dbpassword>@<host>:<port>/<database>

Anteckning

Använd kommandot Kontrollera för att se att den angivna MongoDB-instansen är tillgänglig i anslutningssträngens fält.Use the Verify command to ensure that the MongoDB instance specified in the connection string field can be accessed.

Ange namnet på den samling som data ska importeras från.Enter the name of the collection from which data will be imported. Du kan om du vill ange en fil för en fråga, till exempel {pop: {$gt:5000}}, eller en projektion såsom {loc:0}, för att både filtrera och utforma de data som du importerar.You may optionally specify or provide a file for a query, such as {pop: {$gt:5000}}, or a projection, such as {loc:0}, to both filter and shape the data that you're importing.

Här följer några kommandoradsexempel för import från MongoDB:Here are some command-line samples to import from MongoDB:

#Import all documents from a MongoDB collection
dt.exe /s:MongoDB /s.ConnectionString:mongodb://<dbuser>:<dbpassword>@<host>:<port>/<database> /s.Collection:zips /t:DocumentDBBulk /t.ConnectionString:"AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /t.Collection:BulkZips /t.IdField:_id /t.CollectionThroughput:2500

#Import documents from a MongoDB collection which match the query and exclude the loc field
dt.exe /s:MongoDB /s.ConnectionString:mongodb://<dbuser>:<dbpassword>@<host>:<port>/<database> /s.Collection:zips /s.Query:{pop:{$gt:50000}} /s.Projection:{loc:0} /t:DocumentDBBulk /t.ConnectionString:"AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /t.Collection:BulkZipsTransform /t.IdField:_id/t.CollectionThroughput:2500

Importera MongoDB-exportfilerImport MongoDB export files

Viktigt

Om du importerar till ett Azure Cosmos DB-konto med stöd för MongoDB, följer du dessa anvisningar.If you're importing to an Azure Cosmos DB account with support for MongoDB, follow these instructions.

Med importverktygets alternativ för MongoDB-export av JSON-filkällor, kan du importera en eller flera JSON-filer som skapats med verktyget mongoexport.The MongoDB export JSON file source importer option allows you to import one or more JSON files produced from the mongoexport utility.

Skärmbild av MongoDB-exportkällans alternativ

När du lägger till mappar som har MongoDB-exportens JSON-filer som ska importeras har du möjlighet att rekursivt söka efter filerna i undermappar.When adding folders that have MongoDB export JSON files for import, you have the option of recursively searching for files in subfolders.

Här följer ett kommandoradsexempel när import görs från MongoDB-exportens JSON-filer:Here is a command-line sample to import from MongoDB export JSON files:

dt.exe /s:MongoDBExport /s.Files:D:\mongoemployees.json /t:DocumentDBBulk /t.ConnectionString:"AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /t.Collection:employees /t.IdField:_id /t.Dates:Epoch /t.CollectionThroughput:2500

Importera från SQLServerImport from SQL Server

Med importverktygets alternativ för SQL-källor kan du importera från en enskild SQL Server-databas och du kan också filtrera de poster som ska importeras med hjälp av en fråga.The SQL source importer option allows you to import from an individual SQL Server database and optionally filter the records to be imported using a query. Du kan dessutom ändra dokumentets struktur genom att ange en kapslad avgränsare (mer information om detta kommer längre fram).In addition, you can modify the document structure by specifying a nesting separator (more on that in a moment).

Skärmbild av SQL-källans alternativ – Verktyg för databasmigrering

Formatet för anslutningssträngen är standardformatet för SQL-anslutningssträngar.The format of the connection string is the standard SQL connection string format.

Anteckning

Använd kommandot Kontrollera för att se att den angivna SQL Server-instansen är tillgänglig i anslutningssträngens fält.Use the Verify command to ensure that the SQL Server instance specified in the connection string field can be accessed.

Egenskapen för kapslade avgränsare används för att skapa hierarkiska relationer (underdokument) under importen.The nesting separator property is used to create hierarchical relationships (sub-documents) during import. Fundera över följande SQL-fråga:Consider the following SQL query:

select CAST(BusinessEntityID AS varchar) as Id, Name, AddressType as [Address.AddressType], AddressLine1 as [Address.AddressLine1], City as [Address.Location.City], StateProvinceName as [Address.Location.StateProvinceName], PostalCode as [Address.PostalCode], CountryRegionName as [Address.CountryRegionName] from Sales.vStoreWithAddresses WHERE AddressType='Main Office'

Som returnerar följande (partiella) värden:Which returns the following (partial) results:

Skärmbild av SQL-frågeresultat

Observera alias som t.ex. Address.AddressType och Address.Location.StateProvinceName.Note the aliases such as Address.AddressType and Address.Location.StateProvinceName. När du anger den kapslade avgränsaren '.', skapar importverktyget underdokumenten Address och Address.Location under importen.By specifying a nesting separator of '.', the import tool creates Address and Address.Location subdocuments during the import. Här är ett exempel på ett resulterande dokument i Azure Cosmos DB:Here is an example of a resulting document in Azure Cosmos DB:

{ "id": "956", "Name": "Finer Sales and Service", "Address": { "AddressType": "Main Office", "AddressLine1": "#500-75 O'Connor Street", "Location": { "City": "Ottawa", "StateProvinceName": "Ontario" }, "PostalCode": "K4B 1S2", "CountryRegionName": "Canada" } }{ "id": "956", "Name": "Finer Sales and Service", "Address": { "AddressType": "Main Office", "AddressLine1": "#500-75 O'Connor Street", "Location": { "City": "Ottawa", "StateProvinceName": "Ontario" }, "PostalCode": "K4B 1S2", "CountryRegionName": "Canada" } }

Här följer några kommandoradsexempel för att importera från SQL Server:Here are some command-line samples to import from SQL Server:

#Import records from SQL which match a query
dt.exe /s:SQL /s.ConnectionString:"Data Source=<server>;Initial Catalog=AdventureWorks;User Id=advworks;Password=<password>;" /s.Query:"select CAST(BusinessEntityID AS varchar) as Id, * from Sales.vStoreWithAddresses WHERE AddressType='Main Office'" /t:DocumentDBBulk /t.ConnectionString:" AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /t.Collection:Stores /t.IdField:Id /t.CollectionThroughput:2500

#Import records from sql which match a query and create hierarchical relationships
dt.exe /s:SQL /s.ConnectionString:"Data Source=<server>;Initial Catalog=AdventureWorks;User Id=advworks;Password=<password>;" /s.Query:"select CAST(BusinessEntityID AS varchar) as Id, Name, AddressType as [Address.AddressType], AddressLine1 as [Address.AddressLine1], City as [Address.Location.City], StateProvinceName as [Address.Location.StateProvinceName], PostalCode as [Address.PostalCode], CountryRegionName as [Address.CountryRegionName] from Sales.vStoreWithAddresses WHERE AddressType='Main Office'" /s.NestingSeparator:. /t:DocumentDBBulk /t.ConnectionString:" AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /t.Collection:StoresSub /t.IdField:Id /t.CollectionThroughput:2500

Importera CSV-filer och konvertera CSV till JSONImport CSV files and convert CSV to JSON

Med importverktygets alternativ för CSV-filkällor kan du importera en eller flera CSV-filer.The CSV file source importer option enables you to import one or more CSV files. När du lägger till mappar som har CSV-filer som ska importeras har du möjlighet att rekursivt söka efter filerna i undermappar.When adding folders that have CSV files for import, you have the option of recursively searching for files in subfolders.

Skärmbild av CSV-källans alternativ – CSV till JSON

På samma sätt som med SQL-källan kan egenskapen för kapslade avgränsare användas till att skapa hierarkiska relationer (underdokument) under importen.Similar to the SQL source, the nesting separator property may be used to create hierarchical relationships (sub-documents) during import. Fundera över följande CSV-rubrikrad och datarader:Consider the following CSV header row and data rows:

Skärmbild av CSV-exemplets poster – CSV till JSON

Observera alias som t.ex. DomainInfo.Domain_Name och RedirectInfo.Redirecting.Note the aliases such as DomainInfo.Domain_Name and RedirectInfo.Redirecting. När du anger den kapslade avgränsaren '.', skapar importverktyget underdokumenten DomainInfo och RedirectInfo under importen.By specifying a nesting separator of '.', the import tool will create DomainInfo and RedirectInfo subdocuments during the import. Här är ett exempel på ett resulterande dokument i Azure Cosmos DB:Here is an example of a resulting document in Azure Cosmos DB:

{"DomainInfo": {"Domain_Name": "ACUS.GOV", "Domain_Name_Address": "https: / /www.ACUS.gov"}, "Federal Agency": "administrations konferensen för USA", "RedirectInfo": {"omdirigera": "0", "Redirect_Destination": ""}, "ID": "9cc565c5-EBCD-1c03-ebd3-cc3e2ecd814d"}{ "DomainInfo": { "Domain_Name": "ACUS.GOV", "Domain_Name_Address": "https://www.ACUS.GOV" }, "Federal Agency": "Administrative Conference of the United States", "RedirectInfo": { "Redirecting": "0", "Redirect_Destination": "" }, "id": "9cc565c5-ebcd-1c03-ebd3-cc3e2ecd814d" }

Importverktyget försöker härleda typinformationen för värden utan citattecken i CSV-filer (värden inom citattecken behandlas alltid som strängar).The import tool tries to infer type information for unquoted values in CSV files (quoted values are always treated as strings). Typer identifieras i följande ordning: nummer, datetime, booleskt värde.Types are identified in the following order: number, datetime, boolean.

Det finns två saker att lägga märke till när det gäller CSV-import:There are two other things to note about CSV import:

  1. Som standard tas värden utan citattecken alltid bort för flikar och blanksteg, medan värden inom citattecken sparas som de är.By default, unquoted values are always trimmed for tabs and spaces, while quoted values are preserved as-is. Den här funktionen kan åsidosättas med kryssrutan Trim quoted values (Rensa värden inom citattecken) eller kommandoradsalternativet /s.TrimQuoted.This behavior can be overridden with the Trim quoted values checkbox or the /s.TrimQuoted command-line option.
  2. Som standard behandlas null utan citattecken som ett null-värde.By default, an unquoted null is treated as a null value. Den här funktionen kan åsidosättas (dvs. behandla null utan citattecken som en null-sträng) med kryssrutan Treat unquoted NULL as string (Behandla NULL utan citattecken som en sträng) eller kommandoradsalternativet /s.NoUnquotedNulls.This behavior can be overridden (that is, treat an unquoted null as a "null" string) with the Treat unquoted NULL as string checkbox or the /s.NoUnquotedNulls command-line option.

Här följer ett kommandoradsexempel för CSV-import:Here is a command-line sample for CSV import:

dt.exe /s:CsvFile /s.Files:.\Employees.csv /t:DocumentDBBulk /t.ConnectionString:"AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /t.Collection:Employees /t.IdField:EntityID /t.CollectionThroughput:2500

Importera från Azure Table StorageImport from Azure Table storage

Med importverktygets alternativ för Azure Table Storage-källor kan du importera från en enskild Azure Table Storage-tabell.The Azure Table storage source importer option allows you to import from an individual Azure Table storage table. Du kan också du filtrera tabellentiteterna som ska importeras.Optionally, you can filter the table entities to be imported.

Du kan mata ut data som importerades från Azure Table Storage till Azure Cosmos DB-tabeller och -entiteter för användning med tabell-API.You may output data that was imported from Azure Table Storage to Azure Cosmos DB tables and entities for use with the Table API. Importerade data kan även vara utdata till samlingar och dokument för användning med SQL API.Imported data can also be output to collections and documents for use with the SQL API. Dock är tabell-API endast tillgängligt som mål i kommandoradsverktyget.However, Table API is only available as a target in the command-line utility. Du kan inte exportera till tabell-API med hjälp av användargränssnittet för datamigreringsverktyget.You can't export to Table API by using the Data Migration tool user interface. Se Importera data för användning med Azure Cosmos DB Table-API för mer information.For more information, see Import data for use with the Azure Cosmos DB Table API.

Skärmbild av Azure Table Storage-källans alternativ

Formatet för anslutningssträngen till Azure Table Storage är:The format of the Azure Table storage connection string is:

DefaultEndpointsProtocol=<protocol>;AccountName=<Account Name>;AccountKey=<Account Key>;

Anteckning

Använd kommandot Kontrollera för att se att den angivna Azure Table Storage-instansen är tillgänglig i anslutningssträngens fält.Use the Verify command to ensure that the Azure Table storage instance specified in the connection string field can be accessed.

Ange namnet på Azure-tabellen som du ska importera från.Enter the name of the Azure table from to import from. Du kan också ange ett filter.You may optionally specify a filter.

Importverktygets alternativ för Azure Table Storage-källor innehåller dessutom följande extra alternativ:The Azure Table storage source importer option has the following additional options:

  1. Inkludera interna fältInclude Internal Fields
    1. Alla – Inkludera alla interna fält (PartitionKey, RowKey och Timestamp)All - Include all internal fields (PartitionKey, RowKey, and Timestamp)
    2. Ingen – Undanta alla interna fältNone - Exclude all internal fields
    3. RowKey – Inkludera bara fältet RowKeyRowKey - Only include the RowKey field
  2. Välja kolumnerSelect Columns
    1. Azure Table Storage-filter stöder inte projektioner.Azure Table storage filters don't support projections. Om du endast vill importera specifika entitetsegenskaper från Azure-tabellen, lägger du till dem i listan Välj kolumner.If you want to only import specific Azure Table entity properties, add them to the Select Columns list. Alla andra entitetsegenskaper ignoreras.All other entity properties are ignored.

Här är ett kommandoradsexempel på hur du importerar från Azure Table Storage:Here is a command-line sample to import from Azure Table storage:

dt.exe /s:AzureTable /s.ConnectionString:"DefaultEndpointsProtocol=https;AccountName=<Account Name>;AccountKey=<Account Key>" /s.Table:metrics /s.InternalFields:All /s.Filter:"PartitionKey eq 'Partition1' and RowKey gt '00001'" /s.Projection:ObjectCount;ObjectSize  /t:DocumentDBBulk /t.ConnectionString:" AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /t.Collection:metrics /t.CollectionThroughput:2500

Importera från Amazon DynamoDBImport from Amazon DynamoDB

Med alternativet för Amazon DynamoDB-källimport kan du importera från en enskild Amazon DynamoDB-tabell.The Amazon DynamoDB source importer option allows you to import from a single Amazon DynamoDB table. Det kan även filtrera de entiteter som ska importeras om du väljer det.It can optionally filter the entities to be imported. Det finns flera olika mallar att välja bland, för att konfigurationen av importen ska vara så enkel som möjligt.Several templates are provided so that setting up an import is as easy as possible.

Skärm bild av Amazon DynamoDB-käll alternativ – Migreringsverktyg för databas.

Skärm bild av Amazon DynamoDB-källdata med Migreringsverktyg för databas.

Formatet på Amazon DynamoDB-anslutningssträngen är:The format of the Amazon DynamoDB connection string is:

ServiceURL=<Service Address>;AccessKey=<Access Key>;SecretKey=<Secret Key>;

Anteckning

Använd kommandot Kontrollera för att se att den angivna Amazon DynamoDB-instansen är tillgänglig i anslutningssträngens fält.Use the Verify command to ensure that the Amazon DynamoDB instance specified in the connection string field can be accessed.

Här är ett kommandoradsexempel på hur du importerar från Amazon DynamoDB:Here is a command-line sample to import from Amazon DynamoDB:

dt.exe /s:DynamoDB /s.ConnectionString:ServiceURL=https://dynamodb.us-east-1.amazonaws.com;AccessKey=<accessKey>;SecretKey=<secretKey> /s.Request:"{   """TableName""": """ProductCatalog""" }" /t:DocumentDBBulk /t.ConnectionString:"AccountEndpoint=<Azure Cosmos DB Endpoint>;AccountKey=<Azure Cosmos DB Key>;Database=<Azure Cosmos database>;" /t.Collection:catalogCollection /t.CollectionThroughput:2500

Importera från Azure Blob StorageImport from Azure Blob storage

Med importverktygets alternativ för källor från JSON-filen, MongoDB-exportfilen och CSV-filen, kan du importera en eller flera filer från Azure Blob Storage.The JSON file, MongoDB export file, and CSV file source importer options allow you to import one or more files from Azure Blob storage. När du har angett en URL för blobcontainern och en kontonyckel, använder du ett reguljärt uttryck till att välja vilka filer du vill importera.After specifying a Blob container URL and Account Key, provide a regular expression to select the file(s) to import.

Skärmbild över alternativ för blobfilens källa

Här är ett kommandoradsexempel på hur du kan importera JSON-filer från Azure Blob Storage:Here is command-line sample to import JSON files from Azure Blob storage:

dt.exe /s:JsonFile /s.Files:"blobs://<account key>@account.blob.core.windows.net:443/importcontainer/.*" /t:DocumentDBBulk /t.ConnectionString:"AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /t.Collection:doctest

Importera från en SQL API-samlingImport from a SQL API collection

Med alternativet Azure Cosmos DB source importer kan du importera data från en eller flera Azure Cosmos-behållare och eventuellt filtrera dokument med hjälp av en fråga.The Azure Cosmos DB source importer option allows you to import data from one or more Azure Cosmos containers and optionally filter documents using a query.

Skärmbild över alternativ för Azure Cosmos DB-källor

Anslutningssträngen för Azure Cosmos DB har följande format:The format of the Azure Cosmos DB connection string is:

AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;

Du kan hämta Azure Cosmos DB-kontoanslutningssträngen från sidan Nycklar i Azure-portalen, enligt beskrivningen i Så här hanterar du ett Azure Cosmos DB-konto.You can retrieve the Azure Cosmos DB account connection string from the Keys page of the Azure portal, as described in How to manage an Azure Cosmos DB account. Dock måste namnet på databasen läggas till i anslutningssträngen i följande format:However, the name of the database needs to be appended to the connection string in the following format:

Database=<CosmosDB Database>;

Anteckning

Använd kommandot Kontrollera för att se att den angivna Azure Cosmos DB-instansen är tillgänglig i anslutningssträngens fält.Use the Verify command to ensure that the Azure Cosmos DB instance specified in the connection string field can be accessed.

Om du vill importera från en enda Azure Cosmos-behållare anger du namnet på den samling som du vill importera data från.To import from a single Azure Cosmos container, enter the name of the collection to import data from. Om du vill importera från fler än en Azure Cosmos-behållare anger du ett reguljärt uttryck som matchar ett eller flera samlings namn (till exempel collection01 | collection02 | collection03).To import from more than one Azure Cosmos container, provide a regular expression to match one or more collection names (for example, collection01 | collection02 | collection03). Du kan om du vill ange en fil för en fråga för att både filtrera och utforma de data som du importerar.You may optionally specify, or provide a file for, a query to both filter and shape the data that you're importing.

Anteckning

Eftersom samlingsfältet accepterar reguljära uttryck kommer dessa tecken att hoppas över, om du importerar från en enda samling vars namn innehåller tecken i reguljära uttryck.Since the collection field accepts regular expressions, if you're importing from a single collection whose name has regular expression characters, then those characters must be escaped accordingly.

Importverktygets alternativ för Azure Cosmos DB-källor innehåller följande avancerade alternativ:The Azure Cosmos DB source importer option has the following advanced options:

  1. Inkludera interna fält: Anger om du vill inkludera Azure Cosmos DB-dokumentegenskaper för system i exporten (till exempel _rid, _ts).Include Internal Fields: Specifies whether or not to include Azure Cosmos DB document system properties in the export (for example, _rid, _ts).
  2. Antal återförsök vid fel: Anger hur många gånger systemet försöker återupprätta anslutningen till Azure Cosmos DB vid tillfälliga fel (till exempel avbrott i nätverksanslutningen).Number of Retries on Failure: Specifies the number of times to retry the connection to Azure Cosmos DB in case of transient failures (for example, network connectivity interruption).
  3. Återförsöksintervall: Anger hur lång väntetiden är vid försök att återupprätta anslutningen till Azure Cosmos DB vid tillfälliga fel (till exempel avbrott i nätverksanslutningen).Retry Interval: Specifies how long to wait between retrying the connection to Azure Cosmos DB in case of transient failures (for example, network connectivity interruption).
  4. Anslutningsläge: Anger det anslutningsläge som ska användas med Azure Cosmos DB.Connection Mode: Specifies the connection mode to use with Azure Cosmos DB. Tillgängliga alternativ är DirectTcp, DirectHttps och Gateway.The available choices are DirectTcp, DirectHttps, and Gateway. Direktanslutningslägena är snabbare, medan gatewayläget är mer brandväggsanpassat eftersom det endast använder port 443.The direct connection modes are faster, while the gateway mode is more firewall friendly as it only uses port 443.

Skärmbild över avancerade alternativ för Azure Cosmos DB-källor

Tips

Importverktyget använder som standard anslutningsläget DirectTcp.The import tool defaults to connection mode DirectTcp. Om det uppstår brandväggsproblem kan du växla till anslutningsläget Gateway, eftersom det endast kräver port 443.If you experience firewall issues, switch to connection mode Gateway, as it only requires port 443.

Här följer några kommandoradsexempel på hur du importerar från Azure Cosmos DB:Here are some command-line samples to import from Azure Cosmos DB:

#Migrate data from one Azure Cosmos container to another Azure Cosmos containers
dt.exe /s:DocumentDB /s.ConnectionString:"AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /s.Collection:TEColl /t:DocumentDBBulk /t.ConnectionString:" AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /t.Collection:TESessions /t.CollectionThroughput:2500

#Migrate data from more than one Azure Cosmos container to a single Azure Cosmos container
dt.exe /s:DocumentDB /s.ConnectionString:"AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /s.Collection:comp1|comp2|comp3|comp4 /t:DocumentDBBulk /t.ConnectionString:"AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /t.Collection:singleCollection /t.CollectionThroughput:2500

#Export an Azure Cosmos container to a JSON file
dt.exe /s:DocumentDB /s.ConnectionString:"AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /s.Collection:StoresSub /t:JsonFile /t.File:StoresExport.json /t.Overwrite

Tips

Dataimportverktyget i Azure Cosmos DB har även stöd för import av data från Azure Cosmos DB-emulatorn.The Azure Cosmos DB Data Import Tool also supports import of data from the Azure Cosmos DB Emulator. När du importerar data från en lokal emulator anger du slutpunkten till https://localhost:<port>.When importing data from a local emulator, set the endpoint to https://localhost:<port>.

Importera från HBaseImport from HBase

Med importverktygets alternativ för HBase-källor kan du importera data från en HBase-tabell och du kan också filtrera datan.The HBase source importer option allows you to import data from an HBase table and optionally filter the data. Det finns flera olika mallar att välja bland, för att konfigurationen av importen ska vara så enkel som möjligt.Several templates are provided so that setting up an import is as easy as possible.

Skärm bild av alternativ för HBase-källor.

Skärm bild av alternativen för HBase-källa med snabb menyn för filter expanderad.

Anslutningssträngen för HBase Stargate har följande format:The format of the HBase Stargate connection string is:

ServiceURL=<server-address>;Username=<username>;Password=<password>

Anteckning

Använd kommandot Kontrollera för att se att den angivna HBase-instansen är tillgänglig i anslutningssträngens fält.Use the Verify command to ensure that the HBase instance specified in the connection string field can be accessed.

Här är ett kommandoradsexempel på hur du importerar från HBase:Here is a command-line sample to import from HBase:

dt.exe /s:HBase /s.ConnectionString:ServiceURL=<server-address>;Username=<username>;Password=<password> /s.Table:Contacts /t:DocumentDBBulk /t.ConnectionString:"AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;" /t.Collection:hbaseimport

Importera till SQL API (massimport)Import to the SQL API (Bulk Import)

Med massimportverktyget för Azure Cosmos DB kan du importera från något av källalternativen, med hjälp av en Azure Cosmos DB-lagrad procedur som effektiviserar processen.The Azure Cosmos DB Bulk importer allows you to import from any of the available source options, using an Azure Cosmos DB stored procedure for efficiency. Verktyget stöder import till en enda partitionerad Azure Cosmos-behållare.The tool supports import to one single-partitioned Azure Cosmos container. Det stöder också shardade-import där data partitioneras i mer än en partitionerad Azure Cosmos-behållare.It also supports sharded import whereby data is partitioned across more than one single-partitioned Azure Cosmos container. Mer information om partitionering av data finns i Partitionering och skalning i Azure Cosmos DB.For more information about partitioning data, see Partitioning and scaling in Azure Cosmos DB. Verktyget skapar, kör och tar sedan bort den lagrade proceduren från målsamlingarna.The tool creates, executes, and then deletes the stored procedure from the target collection(s).

Skärmbild över alternativ för Azure Cosmos DB-massimport

Anslutningssträngen för Azure Cosmos DB har följande format:The format of the Azure Cosmos DB connection string is:

AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;

Anslutningssträngen för Azure Cosmos DB-kontot kan hämtas från sidan Nycklar i Azure Portal, enligt beskrivningen i Så här hanterar du ett konto i Azure Cosmos DB, men namnet på databasen måste läggas till i anslutningssträngen i följande format:The Azure Cosmos DB account connection string can be retrieved from the Keys page of the Azure portal, as described in How to manage an Azure Cosmos DB account, however the name of the database needs to be appended to the connection string in the following format:

Database=<CosmosDB Database>;

Anteckning

Använd kommandot Kontrollera för att se att den angivna Azure Cosmos DB-instansen är tillgänglig i anslutningssträngens fält.Use the Verify command to ensure that the Azure Cosmos DB instance specified in the connection string field can be accessed.

Om du ska importera till en enskild samling anger du namnet på samlingen som du ska importera data från. Klicka sedan på knappen Lägg till.To import to a single collection, enter the name of the collection to import data from and click the Add button. Om du vill importera till fler än en samling anger du antingen varje samlingsnamn individuellt, eller så använder du följande syntax för att ange fler än en samling: collection_prefix [start index - end index].To import to more than one collection, either enter each collection name individually or use the following syntax to specify more than one collection: collection_prefix [start index - end index]. Tänk på följande riktlinjer när du anger fler än en samling med hjälp av ovannämnda syntax:When specifying more than one collection using the aforementioned syntax, keep the following guidelines in mind:

  1. Det är bara namnmönster i heltalsintervall som stöds.Only integer range name patterns are supported. Om du till exempel anger collection[0-3] skapas följande samlingar: collection0, collection1, collection2 och collection3.For example, specifying collection[0-3] creates the following collections: collection0, collection1, collection2, collection3.
  2. Du kan använda en förkortad syntax: collection[3] skapar samma uppsättning samlingar som nämns i steg 1.You can use an abbreviated syntax: collection[3] creates the same set of collections mentioned in step 1.
  3. Mer än en ersättning kan anges.More than one substitution can be provided. Till exempel genererar collection[0-1] [0-9] 20 samlingsnamn med inledande nollor (collection01, ..02, ..03).For example, collection[0-1] [0-9] generates 20 collection names with leading zeros (collection01, ..02, ..03).

När samlingsnamnen har angetts väljer du önskad dataflöde för samlingarna (från 400 till 10 000 RU:er).Once the collection name(s) have been specified, choose the desired throughput of the collection(s) (400 RUs to 10,000 RUs). Välj ett högre dataflöde för att få bästa prestandan för importen.For best import performance, choose a higher throughput. Mer information om prestandanivåer finns i avsnittet Prestandanivåer i Azure Cosmos DB.For more information about performance levels, see Performance levels in Azure Cosmos DB.

Anteckning

Inställningen av prestandans dataflöde gäller bara när samlingar skapas.The performance throughput setting only applies to collection creation. Om den angivna samlingen redan finns ändras inte dess dataflöde.If the specified collection already exists, its throughput won't be modified.

När du importerar till fler än en samling stöder importverktyget hash-baserad horisontell partitionering.When you import to more than one collection, the import tool supports hash-based sharding. I det här scenariot anger du den dokumentegenskap som du vill använda som partitionsnyckel.In this scenario, specify the document property you wish to use as the Partition Key. (Om partitionsnyckeln lämnas tom partitioneras dokument horisontellt över målsamlingarna.)(If Partition Key is left blank, documents are sharded randomly across the target collections.)

Du kan om du vill ange vilket fält i importkällan som ska användas som Azure ID-egenskap för Cosmos DB-dokument under importen.You may optionally specify which field in the import source should be used as the Azure Cosmos DB document ID property during the import. Om dokument inte har den här egenskapen genererar importverktyget ett GUID som ID-egenskapsvärde.If documents don't have this property, then the import tool generates a GUID as the ID property value.

Det finns ett antal avancerade alternativ under importen.There are a number of advanced options available during import. Även om verktyget innehåller en standardlagrad procedur för massimport (BulkInsert.js), kan du ange en egen lagrad importprocedur:First, while the tool includes a default bulk import stored procedure (BulkInsert.js), you may choose to specify your own import stored procedure:

Skärmbild över sproc-alternativ för Azure Cosmos DB-massinfogning

När du importerar datumtyper (till exempel från SQL Server eller MongoDB) kan du dessutom välja mellan tre importalternativ:Additionally, when importing date types (for example, from SQL Server or MongoDB), you can choose between three import options:

Skärmbild över importalternativ för datum och tid i Azure Cosmos DB

  • Sträng: Spara som ett strängvärdeString: Persist as a string value
  • Epok: Spara som ett epoknummervärdeEpoch: Persist as an Epoch number value
  • Båda: Spara både strängvärden och epoknummervärden.Both: Persist both string and Epoch number values. Det här alternativet skapar ett underdokument, till exempel: "date_joined": { "Value": "2013-10-21T21:17:25.2410000Z", "Epoch": 1382390245 }This option creates a subdocument, for example: "date_joined": { "Value": "2013-10-21T21:17:25.2410000Z", "Epoch": 1382390245 }

Massimportverktyget för Azure Cosmos DB innehåller följande avancerade extra alternativ:The Azure Cosmos DB Bulk importer has the following additional advanced options:

  1. Batchstorlek: Verktyget har som standard en batchstorlek på 50.Batch Size: The tool defaults to a batch size of 50. Om de dokument som ska importeras är stora kan du minska batchstorleken.If the documents to be imported are large, consider lowering the batch size. Om de dokument som ska importeras är små kan du öka batchstorleken.Conversely, if the documents to be imported are small, consider raising the batch size.
  2. Maxstorlek för skript (byte): Verktyget har som standard en maxstorlek för skript på 512 kB.Max Script Size (bytes): The tool defaults to a max script size of 512 KB.
  3. Inaktivera automatisk ID-generering: Om alla dokument som ska importeras har ett ID-fält kan det här alternativet öka prestandan.Disable Automatic Id Generation: If every document to be imported has an ID field, then selecting this option can increase performance. Dokument som saknar ett fält för unikt ID importeras inte.Documents missing a unique ID field aren't imported.
  4. Uppdatera befintliga dokument: Verktyget ersätter som standard inte befintliga dokument med ID-konflikter.Update Existing Documents: The tool defaults to not replacing existing documents with ID conflicts. Med det här alternativet kan du skriva över befintliga dokument med matchande ID:n.Selecting this option allows overwriting existing documents with matching IDs. Funktionen är användbar vid schemalagda datamigreringar som uppdaterar befintliga dokument.This feature is useful for scheduled data migrations that update existing documents.
  5. Antal återförsök vid fel: Anger hur ofta systemet försöker återupprätta anslutningen till Azure Cosmos DB vid tillfälliga fel (till exempel avbrott i nätverksanslutningen).Number of Retries on Failure: Specifies how often to retry the connection to Azure Cosmos DB during transient failures (for example, network connectivity interruption).
  6. Återförsöksintervall: Anger hur lång väntetiden är vid försök att återupprätta anslutningen till Azure Cosmos DB vid tillfälliga fel (till exempel avbrott i nätverksanslutningen).Retry Interval: Specifies how long to wait between retrying the connection to Azure Cosmos DB in case of transient failures (for example, network connectivity interruption).
  7. Anslutningsläge: Anger det anslutningsläge som ska användas med Azure Cosmos DB.Connection Mode: Specifies the connection mode to use with Azure Cosmos DB. Tillgängliga alternativ är DirectTcp, DirectHttps och Gateway.The available choices are DirectTcp, DirectHttps, and Gateway. Direktanslutningslägena är snabbare, medan gatewayläget är mer brandväggsanpassat eftersom det endast använder port 443.The direct connection modes are faster, while the gateway mode is more firewall friendly as it only uses port 443.

Skärmbild över avancerade alternativ för Azure Cosmos DB-massimport

Tips

Importverktyget använder som standard anslutningsläget DirectTcp.The import tool defaults to connection mode DirectTcp. Om det uppstår brandväggsproblem kan du växla till anslutningsläget Gateway, eftersom det endast kräver port 443.If you experience firewall issues, switch to connection mode Gateway, as it only requires port 443.

Importera till SQL API (import av sekventiella poster)Import to the SQL API (Sequential Record Import)

Med importverktyget för sekventiella poster i Azure Cosmos DB kan du importera från ett tillgängligt källalternativ post för post.The Azure Cosmos DB sequential record importer allows you to import from an available source option on a record-by-record basis. Du kan välja det här alternativet om du importerar till en befintlig samling som har uppnått sin kvot av lagrade procedurer.You might choose this option if you’re importing to an existing collection that has reached its quota of stored procedures. Verktyget stöder import till en enskild Azure Cosmos-behållare (både en partition och flera partitioner).The tool supports import to a single (both single-partition and multi-partition) Azure Cosmos container. Det stöder också shardade-import där data partitioneras i mer än en Azure Cosmos-behållare med en partition eller flera partitioner.It also supports sharded import whereby data is partitioned across more than one single-partition or multi-partition Azure Cosmos container. Mer information om partitionering av data finns i Partitionering och skalning i Azure Cosmos DB.For more information about partitioning data, see Partitioning and scaling in Azure Cosmos DB.

Skärmbild över importalternativ för sekventiella poster i Azure Cosmos DB

Anslutningssträngen för Azure Cosmos DB har följande format:The format of the Azure Cosmos DB connection string is:

AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB Database>;

Du kan hämta anslutningssträngen för Azure Cosmos DB-konto från sidan Nycklar i Azure-portalen, enligt beskrivningen i Så här hanterar du ett Azure Cosmos DB-konto.You can retrieve the connection string for the Azure Cosmos DB account from the Keys page of the Azure portal, as described in How to manage an Azure Cosmos DB account. Dock måste namnet på databasen läggas till i anslutningssträngen i följande format:However, the name of the database needs to be appended to the connection string in the following format:

Database=<Azure Cosmos database>;

Anteckning

Använd kommandot Kontrollera för att se att den angivna Azure Cosmos DB-instansen är tillgänglig i anslutningssträngens fält.Use the Verify command to ensure that the Azure Cosmos DB instance specified in the connection string field can be accessed.

Om du ska importera till en enskild samling anger du namnet på den samling som data ska importeras till och klickar sedan på knappen Lägg till.To import to a single collection, enter the name of the collection to import data into, and then click the Add button. Ange varje samlingsnamn separat om du vill importera till mer än en samling.To import to more than one collection, enter each collection name individually. Du kan även använda följande syntax för att ange mer än en samling: collection_prefix [start index - end index].You may also use the following syntax to specify more than one collection: collection_prefix [start index - end index]. Tänk på följande riktlinjer när du anger fler än en samling via ovannämnda syntax:When specifying more than one collection via the aforementioned syntax, keep the following guidelines in mind:

  1. Det är bara namnmönster i heltalsintervall som stöds.Only integer range name patterns are supported. Om du till exempel anger collection[0-3] skapas följande samlingar: collection0, collection1, collection2 och collection3.For example, specifying collection[0-3] creates the following collections: collection0, collection1, collection2, collection3.
  2. Du kan använda en förkortad syntax: collection[3] skapar samma uppsättning samlingar som nämns i steg 1.You can use an abbreviated syntax: collection[3] creates the same set of collections mentioned in step 1.
  3. Mer än en ersättning kan anges.More than one substitution can be provided. Till exempel skapar samling [0-1] [0-9] 20 samlingsnamn med inledande nollor (collection01, ..02, ..03).For example, collection[0-1] [0-9] creates 20 collection names with leading zeros (collection01, ..02, ..03).

När samlingsnamnen har angetts väljer du önskat dataflöde för samlingarna (från 400 till 250 000 RU:er).Once the collection name(s) have been specified, choose the desired throughput of the collection(s) (400 RUs to 250,000 RUs). Välj ett högre dataflöde för att få bästa prestandan för importen.For best import performance, choose a higher throughput. Mer information om prestandanivåer finns i avsnittet Prestandanivåer i Azure Cosmos DB.For more information about performance levels, see Performance levels in Azure Cosmos DB. Om du importerar till samlingar med dataflöde > 10 000 RU:er måste du ha en partitionsnyckel.Any import to collections with throughput >10,000 RUs require a partition key. Om du vill ha fler än 250 000 RU:er, måste du skicka en begäran i portalen om att öka ditt konto.If you choose to have more than 250,000 RUs, you need to file a request in the portal to have your account increased.

Anteckning

Inställningen av dataflödet gäller bara när samlingar eller databaser skapas.The throughput setting only applies to collection or database creation. Om den angivna samlingen redan finns ändras inte dess dataflöde.If the specified collection already exists, its throughput won't be modified.

Vid import till fler än en samling stöder importverktyget hash-baserad horisontell partitionering.When importing to more than one collection, the import tool supports hash-based sharding. I det här scenariot anger du den dokumentegenskap som du vill använda som partitionsnyckel.In this scenario, specify the document property you wish to use as the Partition Key. (Om partitionsnyckeln lämnas tom partitioneras dokument horisontellt över målsamlingarna.)(If Partition Key is left blank, documents are sharded randomly across the target collections.)

Du kan om du vill ange vilket fält i importkällan som ska användas som Azure ID-egenskap för Cosmos DB-dokument under importen.You may optionally specify which field in the import source should be used as the Azure Cosmos DB document ID property during the import. (Om dokument inte har den här egenskapen genererar importverktyget ett GUID som ID-egenskapsvärde.)(If documents don't have this property, then the import tool generates a GUID as the ID property value.)

Det finns ett antal avancerade alternativ under importen.There are a number of advanced options available during import. När du importerar datumtyper (till exempel från SQL Server eller MongoDB) kan du välja mellan tre importalternativ:First, when importing date types (for example, from SQL Server or MongoDB), you can choose between three import options:

Skärmbild över importalternativ för datum och tid i Azure Cosmos DB

  • Sträng: Spara som ett strängvärdeString: Persist as a string value
  • Epok: Spara som ett epoknummervärdeEpoch: Persist as an Epoch number value
  • Båda: Spara både strängvärden och epoknummervärden.Both: Persist both string and Epoch number values. Det här alternativet skapar ett underdokument, till exempel: "date_joined": { "Value": "2013-10-21T21:17:25.2410000Z", "Epoch": 1382390245 }This option creates a subdocument, for example: "date_joined": { "Value": "2013-10-21T21:17:25.2410000Z", "Epoch": 1382390245 }

Azure Cosmos DB – Importverktyget för sekventiella poster innehåller följande avancerade alternativ:The Azure Cosmos DB - Sequential record importer has the following additional advanced options:

  1. Antal parallella begäranden: Verktyget kan som standard hantera två parallella begäranden.Number of Parallel Requests: The tool defaults to two parallel requests. Om de dokument som ska importeras är små, kan du öka antalet parallella begäranden.If the documents to be imported are small, consider raising the number of parallel requests. Om antalet ökas för mycket kan en nätverksbegränsning uppstå vid importen.If this number is raised too much, the import may experience rate limiting.
  2. Inaktivera automatisk ID-generering: Om alla dokument som ska importeras har ett ID-fält kan det här alternativet öka prestandan.Disable Automatic Id Generation: If every document to be imported has an ID field, then selecting this option can increase performance. Dokument som saknar ett fält för unikt ID importeras inte.Documents missing a unique ID field aren't imported.
  3. Uppdatera befintliga dokument: Verktyget ersätter som standard inte befintliga dokument med ID-konflikter.Update Existing Documents: The tool defaults to not replacing existing documents with ID conflicts. Med det här alternativet kan du skriva över befintliga dokument med matchande ID:n.Selecting this option allows overwriting existing documents with matching IDs. Funktionen är användbar vid schemalagda datamigreringar som uppdaterar befintliga dokument.This feature is useful for scheduled data migrations that update existing documents.
  4. Antal återförsök vid fel: Anger hur ofta systemet försöker återupprätta anslutningen till Azure Cosmos DB vid tillfälliga fel (till exempel avbrott i nätverksanslutningen).Number of Retries on Failure: Specifies how often to retry the connection to Azure Cosmos DB during transient failures (for example, network connectivity interruption).
  5. Återförsöksintervall: Anger hur lång väntetiden är vid försök att återupprätta anslutningen till Azure Cosmos DB vid tillfälliga fel (till exempel avbrott i nätverksanslutningen).Retry Interval: Specifies how long to wait between retrying the connection to Azure Cosmos DB during transient failures (for example, network connectivity interruption).
  6. Anslutningsläge: Anger det anslutningsläge som ska användas med Azure Cosmos DB.Connection Mode: Specifies the connection mode to use with Azure Cosmos DB. Tillgängliga alternativ är DirectTcp, DirectHttps och Gateway.The available choices are DirectTcp, DirectHttps, and Gateway. Direktanslutningslägena är snabbare, medan gatewayläget är mer brandväggsanpassat eftersom det endast använder port 443.The direct connection modes are faster, while the gateway mode is more firewall friendly as it only uses port 443.

Skärmbild över avancerade alternativ för import av sekventiella poster i Azure Cosmos DB

Tips

Importverktyget använder som standard anslutningsläget DirectTcp.The import tool defaults to connection mode DirectTcp. Om det uppstår brandväggsproblem kan du växla till anslutningsläget Gateway, eftersom det endast kräver port 443.If you experience firewall issues, switch to connection mode Gateway, as it only requires port 443.

Ange en indexeringsprincipSpecify an indexing policy

Om du tillåter att migreringsverktyget skapar Azure Cosmos DB SQL API-samlingar under importen, kan du ange indexeringsprincipen för samlingarna.When you allow the migration tool to create Azure Cosmos DB SQL API collections during import, you can specify the indexing policy of the collections. Gå till Indexeringsprincip i avsnittet med avancerade alternativ i alternativen för Azure Cosmos DB-massimport och sekventiella poster i Azure Cosmos DB.In the advanced options section of the Azure Cosmos DB Bulk import and Azure Cosmos DB Sequential record options, navigate to the Indexing Policy section.

Skärm bild av Azure Cosmos DB avancerade alternativ för indexerings princip.

I de avancerade alternativen för indexeringsprinciper kan du välja en indexeringsprincipfil, manuellt ange en indexeringsprincip, eller välja bland en uppsättning standardmallar (genom att högerklicka i textrutan för indexeringsprinciper).Using the Indexing Policy advanced option, you can select an indexing policy file, manually enter an indexing policy, or select from a set of default templates (by right-clicking in the indexing policy textbox).

Principmallarna i verktyget är:The policy templates the tool provides are:

  • Standard.Default. Den här principen är bäst när du utför likhetsfrågor mot strängar.This policy is best when you perform equality queries against strings. Den fungerar även om du använder ORDER BY, intervall och likhetsfrågor för tal.It also works if you use ORDER BY, range, and equality queries for numbers. Den här principen har lägre omkostnad för indexlagring än Intervall.This policy has a lower index storage overhead than Range.
  • Intervall.Range. Den här principen passar bäst när du använder ORDER BY, intervall och likhetsfrågor för både tal och strängar.This policy is best when you use ORDER BY, range, and equality queries on both numbers and strings. Principen har högre omkostnad för indexlagring än Standard och Hash.This policy has a higher index storage overhead than Default or Hash.

Skärm bild av Azure Cosmos DB avancerade alternativ för indexerings princip som anger mål information.

Anteckning

Om du inte anger någon indexeringsprincip används standardprincipen.If you don't specify an indexing policy, then the default policy is applied. Mer information om indexeringsprinciper finns i Azure Cosmos DB-indexeringsprinciper.For more information about indexing policies, see Azure Cosmos DB indexing policies.

Exportera till JSON-filExport to JSON file

Med exportverktyget Azure Cosmos DB JSON kan du exportera alla tillgängliga källalternativ till en JSON-fil som har en matris av JSON-dokument.The Azure Cosmos DB JSON exporter allows you to export any of the available source options to a JSON file that has an array of JSON documents. Verktyget hanterar exporten åt dig.The tool handles the export for you. Alternativt kan du visa resulterande migreringskommando och köra kommandot själv.Alternatively, you can choose to view the resulting migration command and run the command yourself. Den resulterande JSON-filen kan vara lagrad lokalt eller i Azure Blob Storage.The resulting JSON file may be stored locally or in Azure Blob storage.

Skärmbild över exportalternativ för lokal fil i Azure Cosmos DB JSON

Skärmbild över exportalternativ för Azure Cosmos DB Azure Blob Storage

Du kan välja att förenkla resulterande JSON.You may optionally choose to prettify the resulting JSON. Den här åtgärden ökar storleken på det resulterande dokumentet samtidigt som innehållet blir mer läsbart.This action will increase the size of the resulting document while making the contents more human readable.

  • Standard JSON-exportStandard JSON export

    [{"id":"Sample","Title":"About Paris","Language":{"Name":"English"},"Author":{"Name":"Don","Location":{"City":"Paris","Country":"France"}},"Content":"Don's document in Azure Cosmos DB is a valid JSON document as defined by the JSON spec.","PageViews":10000,"Topics":[{"Title":"History of Paris"},{"Title":"Places to see in Paris"}]}]
    
  • Förenklad JSON-exportPrettified JSON export

      [
       {
      "id": "Sample",
      "Title": "About Paris",
      "Language": {
        "Name": "English"
      },
      "Author": {
        "Name": "Don",
        "Location": {
          "City": "Paris",
          "Country": "France"
        }
      },
      "Content": "Don's document in Azure Cosmos DB is a valid JSON document as defined by the JSON spec.",
      "PageViews": 10000,
      "Topics": [
        {
          "Title": "History of Paris"
        },
        {
          "Title": "Places to see in Paris"
        }
      ]
      }]
    

Här är ett kommandoradsexempel på hur du kan exportera JSON-filen till Azure Blob Storage:Here is a command-line sample to export the JSON file to Azure Blob storage:

dt.exe /ErrorDetails:All /s:DocumentDB /s.ConnectionString:"AccountEndpoint=<CosmosDB Endpoint>;AccountKey=<CosmosDB Key>;Database=<CosmosDB database_name>" /s.Collection:<CosmosDB collection_name>
/t:JsonFile /t.File:"blobs://<Storage account key>@<Storage account name>.blob.core.windows.net:443/<Container_name>/<Blob_name>"
/t.Overwrite

Avancerad konfigurationAdvanced configuration

På skärmen Avancerad konfiguration anger du platsen för loggfilen där du vill att eventuella fel skrivs.In the Advanced configuration screen, specify the location of the log file to which you would like any errors written. Följande regler gäller för den här sidan:The following rules apply to this page:

  1. Om ett filnamn inte anges returneras alla fel till sidan Resultat.If a file name isn't provided, then all errors are returned on the Results page.

  2. Om ett filnamn anges utan en katalog, skapas filen (eller skrivs över) i den aktuella katalogen i miljön.If a file name is provided without a directory, then the file is created (or overwritten) in the current environment directory.

  3. Om du väljer en befintlig fil skrivs den över. Det finns inte något alternativ för att lägga till filen.If you select an existing file, then the file is overwritten, there's no append option.

  4. Välj sedan om du vill logga alla, kritiska eller inga felmeddelanden.Then, choose whether to log all, critical, or no error messages. Bestäm slutligen hur ofta den på överföringsmeddelandet på skärmen ska uppdateras med förloppet.Finally, decide how frequently the on-screen transfer message is updated with its progress.

    Skärmbild av skärmen för avancerad konfiguration

Bekräfta importinställningarna och visa kommandoradenConfirm import settings and view command line

  1. När du har angett källinformation, målinformation och avancerad konfiguration granskar du migreringsöversikten och visar eller kopierar det resulterande migreringskommandot om du vill.After you specify the source information, target information, and advanced configuration, review the migration summary and view or copy the resulting migration command if you want. (Att kopiera kommandot är användbart för att automatisera importåtgärder.)(Copying the command is useful to automate import operations.)

    Skärm bild av sammanfattnings skärmen.

    Skärm bild av sammanfattnings skärm med kommando rads förhands granskning.

  2. När du är nöjd med dina käll- och målalternativ klickar du på Importera.Once you’re satisfied with your source and target options, click Import. Förfluten tid, antal överförda och felinformation (om du inte angav ett filnamn i Avancerad konfiguration) uppdateras medan importen pågår.The elapsed time, transferred count, and failure information (if you didn't provide a file name in the Advanced configuration) update as the import is in process. När installationen är klar kan du exportera resultaten (till exempel för att åtgärda eventuella importfel).Once complete, you can export the results (for example, to deal with any import failures).

    Skärm bild av alternativet Azure Cosmos DB JSON-export.

  3. Du kan även starta en ny import genom att antingen återställa alla värden eller behålla de befintliga inställningarna.You may also start a new import by either resetting all values or keeping the existing settings. (Till exempel kan du behålla information om anslutningssträng, val av källa och mål och mer.)(For example, you may choose to keep connection string information, source and target choice, and more.)

    Skärm bild av alternativet Azure Cosmos DB JSON-export med dialog rutan ny import bekräftelse.

Nästa stegNext steps

I den här självstudien har du gjort följande:In this tutorial, you've done the following tasks:

  • Installerat datamigreringsverktygetInstalled the Data Migration tool
  • Importerat data från olika datakällorImported data from different data sources
  • Exporterat från Azure Cosmos DB till JSONExported from Azure Cosmos DB to JSON

Nu kan du gå vidare till nästa självstudie och lära dig att fråga efter data med hjälp av Azure Cosmos DB.You can now proceed to the next tutorial and learn how to query data using Azure Cosmos DB.