Share via

Mengatasi kesalahan migrasi

  • Artikel

Alat Migrasi Data menandai kesalahan yang perlu Anda perbaiki sebelum bermigrasi ke Azure DevOps Services. Artikel ini menjelaskan peringatan dan kesalahan paling umum yang mungkin Anda terima saat bersiap untuk bermigrasi. Setelah Anda memperbaiki setiap kesalahan, jalankan perintah validasi migrator lagi untuk memverifikasi resolusi.

Mengatasi peringatan ukuran

Koleksi ekstra besar mungkin menghasilkan salah satu pesan berikut setelah menjalankan Alat Migrasi Data. Jika Anda menerima salah satu peringatan atau kesalahan ini, kami sarankan Anda mencoba mengurangi ukuran database Anda.

Peringatan berikut berarti Anda perlu menggunakan metode SQL Azure VM untuk menyelesaikan migrasi Anda. Setelah database mencapai ukuran tertentu, menjadi lebih cepat untuk menyiapkan SQL Azure VM untuk menyelesaikan migrasi ke Azure DevOps Services. Untuk menyiapkan VM dan menyelesaikan migrasi Anda, ikuti instruksi yang ditautkan dari pesan peringatan.

The database is currently {Database Size}GBs. This is above the recommended size of {DACPAC Size Limit}GBs to use the DACPAC migration method. Please see the following page to learn how to migration using a SQL Azure VM: https://aka.ms/AzureDevOpsImportLargeCollection

Peringatan ini TIDAK berarti bahwa koleksi Anda terlalu besar untuk migrasi.

Mirip dengan peringatan sebelumnya, peringatan berikut berarti Anda harus menggunakan metode SQL Azure Virtual Machine (VM) untuk menyelesaikan migrasi. Untuk menyiapkan VM dan menyelesaikan migrasi Anda, ikuti instruksi yang ditautkan dari pesan peringatan.

The largest table size is currently {Table size}GBs. This is above the recommended size of {Size limit}GBs to use the DACPAC migration method. Please see the following page to learn how to migration using a SQL Azure VM: https://aka.ms/AzureDevOpsImportLargeCollection

Peringatan ini TIDAK berarti bahwa koleksi Anda terlalu besar untuk migrasi.

Peringatan berikut berarti bahwa database Anda mendekati batas untuk ukuran metadata total. Ukuran metadata mengacu pada ukuran database Anda tanpa menyertakan file, kode, dan data biner lainnya. Kami menyarankan agar Anda mengurangi ukuran database Anda sebelum migrasi. Mengurangi ukuran memberikan manfaat lain untuk mempercepat migrasi Anda.

The database metadata size is currently {Metadata Size}GBs. This is above the recommended size of {Warning Size}GBs. It's recommended that you consider cleaning up older data as described in [Cleaning up old data](/azure/devops/server/upgrade/clean-up-data).

Peringatan TIDAK berarti bahwa koleksi Anda terlalu besar untuk migrasi, melainkan ukuran metadatanya lebih besar dari kebanyakan database lainnya.

Ukuran metadata database melebihi ukuran maksimum yang didukung

Tidak seperti peringatan sebelumnya, kesalahan berikut AKAN memblokir Anda untuk bergerak maju dengan migrasi Anda.

Ini menunjukkan bahwa volume metadata dalam koleksi Anda terlalu besar. Untuk melanjutkan migrasi, Anda perlu mengurangi ukuran di bawah batas yang ditunjukkan.

The database metadata size is currently {Metadata Size}GBs. This is above the maximum supported size of {Metadata Limit}GBs.

Mengatasi peringatan kolabasi

Peringatan kolabasi mengacu pada kolae database koleksi Anda. Kolase mengontrol cara nilai string diurutkan dan dibandingkan. Koleksi yang tidak menggunakan salah SQL_Latin1_General_CP1_CI_AS satu atau Latin1_General_CI_AS menerima salah satu pesan peringatan .

Tidak ada dukungan asli

Menerima peringatan berikut berarti Anda perlu mempertimbangkan implikasi kolabasi sebelum melakukan migrasi.

The collection database's collation '{collation}' is not natively supported in Azure DevOps Services. Importing your collection will result in your collation being converted to one of the supported Azure DevOps Services collations. See more details at https://aka.ms/AzureDevOpsImportCollations

Peringatan ini TIDAK berarti Bahwa Anda tidak dapat memigrasikan koleksi Anda.

Peringatan ini mengharuskan Anda untuk mengakui penerimaan peringatan. Menerima peringatan memungkinkan Alat Migrasi Data untuk melanjutkan persiapan migrasi.

Saat Anda memigrasikan kolase yang tidak didukung ke Azure DevOps Services, kolase diubah menjadi kolase yang didukung. Meskipun transformasi ini umumnya berfungsi tanpa masalah, hasil yang tidak terduga pasca migrasi atau kegagalan migrasi dapat terjadi.

Misalnya, pelanggan mungkin melihat pemesanan yang berbeda untuk string yang berisi karakter non-bahasa Inggris. Karakter non-bahasa Inggris seperti 'é' mungkin setara dengan bahasa Inggris 'e' setelah migrasi. Penting agar Anda menyelesaikan dan memverifikasi migrasi uji coba saat Memigrasikan koleksi dengan kolase yang tidak didukung.

Tidak ada dukungan asli, tidak ada koneksi internet

Jika Alat Migrasi Data tidak dapat tersambung ke internet, Alat Migrasi Data tidak dapat memvalidasi konversi kolamen Anda. Ini hanya peringatan, sehingga Anda dapat melanjutkan proses migrasi Anda. Namun, ketika Anda menjalankan perintah persiapan , koneksi internet diperlukan dan konversi kolase divalidasi pada saat itu.

The collections database's collation '{collation}' is not natively supported in Azure DevOps Services. It could not be validated that the collation can be converted during migration to a supported Azure DevOps Services collation, as there was no internet connection. Please run the command again from a machine with an internet connection. See more details at https://aka.ms/AzureDevOpsImportCollations

Kolase database yang tidak didukung

Umumnya Anda dapat mengonversi kolase yang tidak didukung ke kolase yang didukung pada waktu migrasi. Namun, beberapa kolase tidak dapat dikonversi. Jika koleksi Anda menggunakan salah satu kolas ini, Anda akan menerima pesan kesalahan berikut.

The collection database's collation '{collation}' is not supported for migration to Azure DevOps Services. It will need to be changed to a supported collation before it can be imported. See more details at https://aka.ms/AzureDevOpsImportCollations

Untuk melanjutkan, Anda perlu mengubah kolater koleksi Anda menjadi salah satu kolatasi yang didukung di Azure DevOps Services.

Mengatasi kesalahan identitas

Perbaiki kesalahan identitas sebelum migrasi untuk mencegah masalah. Ini jarang terjadi dan terjadi ketika operasi TFS lama tidak valid di Azure DevOps Server baru. Misalnya, beberapa pengguna tidak dapat berada di grup pengguna yang valid lagi.

Bagian berikut ini menyediakan panduan untuk menyelesaikan kesalahan identitas yang paling umum.

ISVError: 100014

Kesalahan ini menunjukkan bahwa izin hilang dari grup keamanan sistem. Misalnya, setiap koleksi yang Anda buat memiliki grup Pengguna Valid Koleksi Proyek dan Administrator Koleksi Proyek. Sistem membuatnya secara default. Grup ini tidak mendukung pengeditan izin mereka.

Kesalahan ini menunjukkan bahwa satu atau beberapa grup tidak memiliki izin yang harus dimilikinya. Untuk mengatasi kesalahan ini, gunakan perintah TFSSecurity.exe untuk menerapkan izin yang diharapkan ke grup sistem yang ditandai. Langkah pertama Anda adalah mengidentifikasi perintah TFSSecurity mana yang perlu Anda jalankan.

Pesan kesalahan Pengguna Valid Koleksi Proyek

Periksa satu atau beberapa pesan kesalahan yang disorot Alat Migrasi Data. Jika grup yang ditandai berakhiran dengan "0-0-0-0-3", seperti dalam contoh berikut, Anda perlu memperbaiki izin yang hilang untuk grup Pengguna Valid Koleksi Proyek.

Jalankan perintah berikut, ganti cakupan dengan cakupan dari pesan kesalahan dan tentukan URL koleksi Anda.

TFSSecurity.exe /a+ Identity "{scope}\\" Read sid:{Group SID} ALLOW /collection:{collectionUrl}

Anda menentukan cakupan dan ID keamanan grup (SID) dari pesan kesalahan.

ISVError:100014 Missing permission for group:Microsoft.TeamFoundation.Identity;S-1-9-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-0-0-0-0-3 for scope:397c326b-b97c-4510-8271-75aac13de7a9. Expected:1 and Actual:0

Perintah akhir tampak mirip dengan entri berikut:

TFSSecurity.exe /a+ Identity "397c326b-b97c-4510-8271-75aac13de7a9\\" Read sid:S-1-9-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-0-0-0-0-3 ALLOW /collection:https://localhost:8080/defaultcollection

Pesan kesalahan Administrator Koleksi Proyek

Periksa dengan cermat pesan kesalahan yang disorot Alat Migrasi Data. Jika grup yang ditandai yang diakhir dengan "0-0-0-0-1", seperti dalam contoh berikut, maka Anda perlu memperbaiki izin yang hilang untuk grup Administrator Koleksi Proyek. Jalankan perintah berikut terhadap TFSSecurity.exe, ganti cakupan dengan yang dari pesan kesalahan dan tentukan koleksi Anda.

TFSSecurity.exe /a+ Identity "{scope}\\" Read sid:{Group SID} ALLOW /collection:{collectionUrl}

TFSSecurity.exe /a+ Identity "{scope}\\" Write sid:{Group SID} ALLOW /collection:{collectionUrl}

TFSSecurity.exe /a+ Identity "{scope}\\" Delete sid:{Group SID} ALLOW /collection:{collectionUrl}

TFSSecurity.exe /a+ Identity "{scope}\\" ManageMembership sid:{Group SID} ALLOW /collection:{collectionUrl}

Dalam contoh berikut, ambil cakupan dan grup SID dari pesan kesalahan dan tambahkan ke perintah sebelumnya.

ISVError:100014 Missing permission for group:Microsoft.TeamFoundation.Identity;S-1-9-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-0-0-0-0-1 for scope:0c7c2216-fa4b-4107-a203-82b324a147ef. Expected:15 and Actual:0

Perintah akhir tampak mirip dengan entri berikut:

TFSSecurity.exe /a+ Identity "0c7c2216-fa4b-4107-a203-82b324a147ef\\" Read sid:S-1-9-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-0-0-0-0-1 ALLOW /collection:https://localhost:8080/defaultcollection

TFSSecurity.exe /a+ Identity "0c7c2216-fa4b-4107-a203-82b324a147ef\\" Write sid:S-1-9-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-0-0-0-0-1 ALLOW /collection:https://localhost:8080/defaultcollection

TFSSecurity.exe /a+ Identity "0c7c2216-fa4b-4107-a203-82b324a147ef\\" Delete sid:S-1-9-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-0-0-0-0-1 ALLOW /collection:https://localhost:8080/defaultcollection

TFSSecurity.exe /a+ Identity "0c7c2216-fa4b-4107-a203-82b324a147ef\\" ManageMembership sid:S-1-9-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-0-0-0-0-1 ALLOW /collection:https://localhost:8080/defaultcollection

Ketika Anda perlu memperbaiki beberapa kesalahan, kami sarankan Anda membuat file batch untuk mengotomatiskan eksekusi perintah. Setelah Anda menjalankan perintah, jalankan ulang alat validasi migrasi data untuk memverifikasi resolusi. Jika beberapa kesalahan masih berlanjut, hubungi dukungan pelanggan Azure DevOps Services.

ISVError: 300005

ISVError: 300005 menunjukkan bahwa identitas nongroup adalah anggota grup semua orang, yang lebih dikenal sebagai grup Pengguna Valid. Grup Pengguna yang Valid adalah grup default yang ditentukan untuk semua proyek dan koleksi. Grup ini tidak dapat diedit. Mereka dirancang untuk hanya berisi izin Azure DevOps lainnya atau grup keamanan sebagai anggota. Kesalahan ini menunjukkan bahwa grup Direktori Aktif (AD) atau identitas pengguna memiliki keanggotaan langsung di grup Pengguna yang Valid.

Penting

Pastikan Anda memiliki cadangan database koleksi dan konfigurasi sebelum menjalankan perintah berikut untuk mengatasi kesalahan.

Karena Anda tidak dapat langsung mengedit grup Pengguna Yang Valid, Anda perlu menjalankan pernyataan SQL terhadap database konfigurasi untuk menghapus identitas yang menyinggung dan memperbaiki keanggotaan yang tidak valid. Periksa dengan cermat pesan kesalahan yang disorot oleh Alat Migrasi Data. GroupSidSalin , MemberId, dan ScopeId karena Anda perlu menempatkan nilai-nilai ini ke dalam perintah berikut.

DECLARE @p6 dbo.typ_GroupMembershipTable

INSERT into @p6 values('{GroupSid}','Microsoft.TeamFoundation.Identity','{MemberId}',0)
 
EXEC prc_UpdateGroupMembership @partitionId=1,@scopeId='{ScopeId}',@idempotent=1,@incremental=1,@insertInactiveUpdates=0,@updates=@p6,@eventAuthor='9EE20697-5343-43FC-8FC5-3D5D455D21C5',@updateGroupAudit=0

Contoh berikut mencantumkan contoh ISVError: 300005 pesan dari Alat Migrasi Data.

ISVError:300005 Unexpected non group identity was found to have direct membership to everyone group. GroupSid:S-1-9-1551374245-3746625149-2333054533-2458719197-2313548623-0-0-0-0-3, MemberId:76050ddf-4fd8-48c4-a1ff-859e44364519, ScopeId:7df650df-0f8b-4596-928d-13dd89e5f34f

Jika pesan kesalahan mencantumkan MemberSid, Anda perlu mendapatkan MemberID dari tabel dbo.tbl_Identity dalam database konfigurasi. MemberIDDengan , Anda kemudian dapat mencari GUID untuk MemberSid.

ISVError:300005 Unexpected non group identity was found to have direct membership to everyone group. GroupSid:S-1-9-1551374245-3746625149-2333054533-2458719197-2313548623-0-0-0-0-3, MemberSid:System.Security.Principal.WindowsIdentity;S-1-5-21-124525095-708259637-1543119021-1737349, ScopeId:7df650df-0f8b-4596-928d-13dd89e5f34f

DECLARE @MemberId uniqueidentifier 

SET @MemberId = (Select Id from dbo.tbl_Identity where Sid ='S-1-5-21-124525095-708259637-1543119021-1737349');

SELECT @MemberId

GroupSidSalin , MemberId, dan ScopeId ke dalam perintah SQL.


DECLARE @p6 dbo.typ_GroupMembershipTable

INSERT into @p6 values('S-1-9-1551374245-3746625149-2333054533-2458719197-2313548623-0-0-0-0-3','Microsoft.TeamFoundation.Identity','76050ddf-4fd8-48c4-a1ff-859e44364519',0)
 
EXEC prc_UpdateGroupMembership @partitionId=1,@scopeId='7df650df-0f8b-4596-928d-13dd89e5f34f',@idempotent=1,@incremental=1,@insertInactiveUpdates=0,@updates=@p6,@eventAuthor='9EE20697-5343-43FC-8FC5-3D5D455D21C5'

Jalankan perintah yang telah selesai terhadap database konfigurasi Azure DevOps Server. Ulangi perintah ini untuk setiap ISVError: instans 300005 yang dilaporkan. Anda dapat membuat batch kesalahan dengan ID cakupan yang sama ke dalam satu perintah. Setelah Anda menjalankan perintah, jalankan ulang Alat Migrasi Data validasi lagi untuk memastikan bahwa kesalahan diperbairah. Jika kesalahan masih berlanjut, hubungi dukungan pelanggan Azure DevOps Services.

Penting

Untuk mengatasi kesalahan ini, koleksi harus dilampirkan.

Jika Anda menerima hasil -1 saat menjalankan perintah, pastikan database koleksi Anda yang menghasilkan kesalahan dilampirkan ke instans Azure DevOps Server Anda dan Anda menjalankan perintah pada database konfigurasi.

Pengecualian batas waktu Microsoft Entra

Pada kesempatan yang jarang terjadi, Anda mungkin menerima kesalahan batas waktu Microsoft Entra saat menjalankan perintah persiapan Alat Migrasi Data.

Exception Message: Request failed (type AadGraphTimeoutException)

Kesalahan ini berarti bahwa permintaan ke ID Microsoft Entra untuk menemukan identitas Microsoft Entra yang cocok untuk pengguna dalam waktu habis koleksi Anda. Umumnya, Anda dapat mengatasi kesalahan ini dengan menunggu untuk menjalankan perintah persiapan pada waktu yang kurang sibuk dalam sehari, seperti setelah jam kerja reguler.

Untuk memecahkan masalah, uji koneksi ID Microsoft Entra dari komputer persiapan . Ikuti langkah-langkah ini untuk mendapatkan info pengguna dari ID Microsoft Entra.

Buka PowerShell dalam mode yang ditingkatkan dan ganti 'someone@somecompany.com' dalam perintah berikut dengan identitas pengguna Microsoft Entra Anda.

# Install the Microsoft Graph PowerShell module - ensuring to select Yes to All
Install-Module Microsoft.Graph 

# Import Users module
Import-Module Microsoft.Graph.Users

# Connect to Microsoft Entra and use your Microsoft Entra ID credentials (someone@somecompany.com) to login when the pop-up appears
Connect-MgGraph  -Scopes 'User.Read.All'

# Try to retrieve information on a user from your Microsoft Entra
Get-MgUser -Filter "UserPrincipalName eq 'someone@somecompany.com'"

Jika langkah-langkah gagal atau Anda tidak dapat menemukan pengguna, periksa koneksi antara komputer persiapan dan ID Microsoft Entra. Jalankan jejak jaringan dengan bersiap untuk melihat apakah jaringan memblokir panggilan. Jika tidak, hubungi dukungan Azure. Periksa file log untuk informasi pengguna.

Number of active users is {Number of Users}.

Jika jumlah pengguna aktif lebih dari 50.000, volume identitas yang dipetakan mungkin memerlukan lebih banyak waktu daripada yang disediakan oleh batas waktu habis. Periksa koleksi Anda untuk dimasukkannya grup besar seperti grup 'semua orang'. Jika memungkinkan, hapus grup ini dan coba lagi. Jika Anda masih tidak dapat mengatasi kesalahan ini, hubungi dukungan pelanggan Azure DevOps Services.

Mengatasi kesalahan proses

Lihat artikel Validasi fase, Mengatasi templat proses untuk detail tentang mengatasi kesalahan proses umum.

Mengatasi kesalahan validasi bidang

VS403310

Pesan kesalahan berikut dapat terjadi ketika inkonsistensi dalam file koleksi terdeteksi. Hubungi dukungan pelanggan jika Anda mengalami kesalahan ini.

VS403310: An inconsistency was detected in some of the files in the collection.

VS403442

Konflik nama bidang terkadang terjadi antara koleksi lokal Anda dan bidang sistem Azure DevOps Services.

In order to migrate successfully, you must rename field *{TFSfieldReferenceName}*. Given name *{TFSfieldName}* is reserved for field *{VSTSfieldReferenceName}*.

Untuk mengatasi kesalahan ini, ubah nama bidang koleksi Anda. Gunakan perintah witadmin changefield dari witadmin.

witadmin changefield /collection:http://AdventureWorksServer:8080/DefaultCollection /n:TFSfieldReferenceName /name:newFieldName

VS403443

Kesalahan berikut menunjukkan konflik nama bidang ada antara koleksi lokal Anda dan bidang Layanan Azure DevOps tertentu.

In order to migrate successfully, you must rename field *{TFSfieldReferenceName}* to *{VSTSfieldName}*. Given name for *{TFSfieldReferenceName}* is *{TFSfieldName}*

Untuk mengatasi kesalahan ini, gunakan perintah witadmin changefield . Untuk detailnya, lihat witadmin.

witadmin changefield /collection:http://AdventureWorksServer:8080/DefaultCollection /n:TFSfieldReferenceName /name:VSTSfieldName

VS403444

Kesalahan berikut menunjukkan konflik jenis bidang ada antara koleksi lokal Anda dan Azure DevOps Services.

Dengan menggunakan witadmin, Anda dapat mengubah jenis data hanya untuk bidang HTML atau PlainText.

In order to migrate successfully, you must set type of field *{TFSfieldReferenceName}* to *{Type}*. Given type for *{TFSfieldReferenceName}* is *{collectionType}*.

Jika jenis bidang Anda adalah HTML atau PlainText, maka Anda dapat mengubah jenisnya ke jenis yang diperlukan.

witadmin changefield /collection:http://AdventureWorksServer:8080/DefaultCollection /n:TFSfieldReferenceName  /type:PlainText | HTML

Catatan

Jika jenis bidang Anda berbeda dari HTML atau PlainText dan data bidang tidak penting atau bidang tidak digunakan dalam proyek apa pun, kami sarankan Anda menghapus bidang tersebut.

witadmin deletefield /collection:http://AdventureWorksServer:8080/DefaultCollection /n:TFSfieldReferenceName

Penting

Menghapus bidang menghasilkan hilangnya data bidang di seluruh koleksi.

Mengatasi kegagalan verifikasi

Kegagalan verifikasi berarti migrasi tidak dimulai. Alat Migrasi Data mencoba mengantre migrasi, tetapi mendapat kesalahan sebagai gantinya. Permintaan migrasi Anda tidak valid. Perbaiki pesan kesalahan lalu coba migrasikan lagi.

VS403254

Wilayah yang Anda masukkan untuk migrasi Azure DevOps Services Anda tidak didukung.

VS403254: Region {0} might not be used for the Import, it is not a supported region.

Buka file spesifikasi migrasi Anda dan perbarui wilayah yang Anda berikan dengan nama pendek yang benar untuk wilayah tersebut.

VS403249

Nama organisasi yang dipilih tim Anda sudah digunakan oleh organisasi yang sudah ada. Semua migrasi Azure DevOps Services masuk ke organisasi baru yang dibuat pada waktu migrasi.

VS403249: The organization {0} already exists. Please select a different name and try the migration again.

Pilih nama organisasi yang berbeda dan perbarui file spesifikasi migrasi sebelum mencoba kembali migrasi.

VS403250 &VS403286

DACPAC tidak dibangun dari koleksi yang dilepaskan.

VS403250: The dacpac is not a detached Azure DevOps Server Collection database.

VS403286: The dacpac is from a Azure DevOps Server Configuration database. You must use a detached Azure DevOps Server Collection database.

Lepaskan database koleksi Anda dan hasilkan DACPAC lagi.

VS403243

Tidak dapat membuat koneksi ke database menggunakan String Koneksi ion SQL yang disediakan.

VS403243: Unable to connect to the database using the provided SQL Connection String {0}.

Tinjau parameter yang disediakan untuk memastikan parameter tersebut benar dan coba lagi.

VS403260 &VS403351

Database koleksi tidak dilepaskan.

VS403260: The database is not detached.

VS403351: The DACPAC or source database is missing an expected table. It's possible that the database was not correctly detached from Azure DevOps Server.

Lepaskan database koleksi Anda dan coba lagi antrean migrasi.

VS403261

String koneksi harus dienkripsi jika tidak, kata sandi dikirim dengan jelas.

VS403261: The SQL connection string must use encryption.

Tambahkan Encrypt=true ke string koneksi SQL Anda.

VS403262

string koneksi harus menggunakan Autentikasi SQL.

VS403262: The SQL connection string must use SQL Authentication, Integrated Authentication is not supported.

Tambahkan Integrated Security=False ke string koneksi SQL Anda.

VS403263

Akun pengguna masuk SQL Anda tidak memiliki peran database yang diperlukan.

VS403263: The User ID {0} must be member of the database role {1}.

Pastikan akun pengguna untuk masuk diberi peran 'TFSEXECROLE '.

Catatan

Ada masalah yang diketahui dengan menggunakan sp_addrolemember untuk menambahkan TFSEXECROLE ke login SQL yang ada. Keanggotaan peran tidak diterapkan sampai semua koneksi terbuka yang menggunakan identitas tersebut ditutup. Jika Anda menerima kesalahan VS403263 dan telah mengonfirmasi bahwa identitas Anda memiliki peran, kami sarankan Anda membuat identitas baru untuk migrasi Anda.

VS403264

string koneksi tidak menunjuk ke database koleksi Azure DevOps Server.

VS403264: The database is not a Azure DevOps Server Collection database, it cannot be used for migration.

Verifikasi atau koreksi string koneksi menunjuk ke database koleksi Anda.

VS40325

Pembaruan Server Azure DevOps telah mengantrekan pekerjaan migrasi file. Anda tidak dapat melakukan migrasi hingga pekerjaan ini selesai. Waktu penyelesaian untuk pekerjaan ini tergantung pada ukuran koleksi.

VS403255: The collection cannot be imported due to an ongoing post upgrade job. Please wait and try again later

Anda dapat melacak kemajuan pekerjaan dengan menjalankan kueri berikut pada database koleksi:

SELECT  COUNT (*) as remaining_files_to_migrate
FROM    tbl_FileReference
WHERE   PartitionId > 0
        AND MigrateFileId IS NOT NULL

Setelah jumlah file yang tersisa untuk dimigrasikan adalah nol, Anda dapat menjalankan Alat Migrasi Data.

VS403282

Karakter baris baru ada di nilai lokasi sumber. Karakter ini mungkin tetap ada setelah menyalin kunci SAS dari konsol windows Anda.

VS403282: The source location parameter contains a new line character. Please ensure the SAS key is defined on a single line in the migration specification file.

Hapus pemisah baris dan coba lagi.

VS403271

File migrasi dan DACPAC Anda tidak terletak di wilayah Azure yang diperlukan untuk menyelesaikan migrasi ke wilayah Azure DevOps Services target Anda.

VS403271: It appears that your DACPAC was uploaded to East US. It's required that customers targeting Central US for migration put their DACPACs in Central US. Please move your DACPAC to Central US and requeue the migration.

Buat akun penyimpanan Microsoft Azure baru di wilayah yang diperlukan dan salin file Anda. Contoh berikut menunjukkan cara menyalin data Anda menggunakan AzCopy.

AzCopy.exe /Source:https://accountSCUS.blob.core.windows.net/mycontainer /SourceKey:"primary access key" /Dest:https://accountCUS.blob.core.windows.net/mycontainer /DestKey:"primary access key" /S

VS403316

Inkonsistensi terdeteksi dalam beberapa file kontrol versi Team Foundation (TFVC) dalam koleksi Anda.

VS403316: An inconsistency was detected in some TFVC files for this collection. The inconsistency needs to be corrected prior to running a migration to Azure DevOps Services. Please reach out to https://aka.ms/AzureDevOpsImportSupport for assistance with addressing this issue.

Bekerja dengan dukungan pelanggan Azure DevOps Services. Buka tiket dukungan dan mereka bekerja sama dengan Anda untuk mengatasi kesalahan.

VS403366

Alat Migrasi Data tidak dapat tersambung ke SQL Azure VM.

VS403366: A problem occurred while attempting to connect to your database. Please verify that your connection string is correct and that all required IP addresses for Azure DevOps Services have been provided exceptions for your machines firewall.

List of Azure DevOps Services IPs:

Verifikasi bahwa Anda memasukkan informasi dengan benar di string koneksi dan Anda dapat tersambung ke VM.

IP yang dicantumkan pesan kesalahan adalah untuk Azure DevOps Services. IP Azure DevOps Services dapat berubah sementara selama penyebaran. Tambahkan ke pengecualian firewall Anda dan coba antre migrasi lagi. Untuk daftar alamat IP, lihat Memigrasikan koleksi besar, Membatasi akses ke IP Azure DevOps Services saja.

VS403373

Alat Migrasi Data tidak mendukung migrasi beberapa salinan koleksi SAME . Namun, INI MENDUKUNG migrasi salinan terpisah dari koleksi. Ubah GUID untuk DataImportCollectionID.

Dari SQL Server Management Studio (SSMS), buka properti yang diperluas untuk salinan terpisah yang belum Anda migrasikan. Tambahkan GUID yang baru dibuat ke properti "TFS_DATAIMPORT_COLLECTIONID". Kemudian jalankan kembali perintah siapkan dan gunakan file migration.json baru untuk mengantrekan migrasi.

VS403379

Migrasi data gagal karena satu atau beberapa proyek yang ditemukan dalam koleksi ini berada dalam tahap penghapusan sementara. Pulihkan proyek yang dihapus sementara atau hapus secara permanen sebelum menjalankan migrasi data. Untuk detailnya, lihat Menghapus proyek.

VS403379: Data migration will fail as one or more projects found in this collection are in the soft-deleted stage. Please restore the soft-deleted project(s) or delete them permanently before running the data migration.

Verifikasi koleksi tempat Anda menjalankan Alat Migrasi Data memiliki proyek dalam tahap penghapusan sementara. Setelah proyek dihapus, proyek tetap dalam status penghapusan sementara selama 28 hari di mana proyek yang dihapus dapat dipulihkan. Anda dapat membaca tentang cara memulihkan proyek yang dihapus di Memulihkan proyek. Jika Anda memiliki proyek dalam tahap penghapusan sementara, hapus sepenuhnya atau pulihkan kembali sebelum menjalankan migrasi data.

Mengatasi kegagalan migrasi

Kegagalan migrasi berarti bahwa migrasi diantrekan, tetapi tidak selesai. Individu yang mengantrekan migrasi menerima pemberitahuan email kegagalan. Sebagian besar waktu email ini mencakup alasan kegagalan. Jika ya, gunakan langkah-langkah pemecahan masalah yang disediakan di email dan halaman ini untuk mengatasi kesalahan dan mencoba kembali migrasi Anda.

Jika kesalahan lebih kompleks, maka email yang Anda terima memberikan instruksi tentang cara mengajukan kasus dukungan pelanggan. Setelah Anda mengirimkan kasus dukungan pelanggan, tim Anda harus kembali dengan membawa instans Azure DevOps Server Anda kembali online dan memasang kembali koleksi Anda. Anggota tim Anda kemudian dapat terus bekerja. Kami menyarankan agar Anda tidak mencoba migrasi lagi hingga kegagalan yang menyebabkan masalah teratasi.