Mengatasi kesalahan migrasi

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

Untuk bantuan selengkapnya, lihat bagian FAQ di akhir artikel ini.

Memperbaiki peringatan tentang ukuran

Koleksi ekstra besar mungkin menghasilkan salah satu pesan berikut setelah menjalankan Alat Migrasi Data. Jika Anda menerima salah satu peringatan atau kesalahan ini, coba kurangi 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. Kurangi ukuran database Anda sebelum migrasi. Mengurangi ukuran juga 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; sebaliknya, ukuran metadata-nya lebih besar daripada kebanyakan database lainnya.

Ukuran metadata database melebihi ukuran maksimum yang didukung

Tidak seperti peringatan sebelumnya, kesalahan berikut akan menghalangi Anda untuk melanjutkan migrasi Anda.

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

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

Mengatasi peringatan pengurutan

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

Tidak ada dukungan bawaan

Jika Anda menerima peringatan berikut, pertimbangkan implikasi kolatasi 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 Anda tidak dapat memigrasikan koleksi Anda.

Anda perlu 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, Anda mungkin melihat pengurutan 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 pengujian migrasi ketika memigrasikan koleksi dengan pengurutan yang tidak didukung.

Tidak ada dukungan asli, tidak ada koneksi internet

Jika Alat Migrasi Data tidak dapat tersambung ke internet, alat tersebut tidak dapat memvalidasi konversi pengurutan Anda. Ini hanya peringatan, sehingga Anda dapat melanjutkan proses migrasi Anda. Namun, ketika Anda menjalankan perintah siapkan, 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

Pengurutan basis data 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 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, ubah kolagasi koleksi Anda menjadi salah satu kolatasi yang didukung di Azure DevOps Services.

Mengatasi kesalahan identitas

Perbaiki kesalahan identitas sebelum migrasi untuk mencegah masalah. Kesalahan ini jarang terjadi dan terjadi ketika operasi lama tidak valid di Azure DevOps Server baru. Misalnya, beberapa pengguna mungkin tidak lagi menjadi bagian dari grup pengguna yang valid.

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 Koleksi Proyek Valid dan Administrator Koleksi Proyek. Sistem membuat grup ini secara default. Anda tidak dapat mengedit izin untuk grup ini.

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 dalam Koleksi Proyek

Periksa satu atau beberapa pesan kesalahan yang disorot Alat Migrasi Data. Jika grup yang ditandai berakhir 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 berakhir dengan "0-0-0-0-1", seperti dalam contoh berikut, 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

Saat Anda perlu memperbaiki beberapa kesalahan, buat 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 non-kelompok adalah anggota grup semua pengguna, yang lebih dikenal sebagai grup Pengguna Terverifikasi. Grup Pengguna yang Valid adalah grup default yang ditentukan untuk semua proyek dan koleksi. Anda tidak dapat mengedit grup ini. 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 mencadangkan 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 nilai , 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

Berikut adalah contoh pesan ISVError: 300005 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. Dengan MemberID, 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 nilai , 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 mengelompokkan kesalahan dengan ID cakupan yang sama ke dalam satu perintah. Setelah Anda menjalankan perintah, jalankan ulang Alat Migrasi Data dan validasi lagi untuk memastikan bahwa kesalahan diperbaiki. Jika kesalahan masih berlanjut, hubungi dukungan pelanggan Azure DevOps Services.

Penting

Untuk mengatasi kesalahan ini, Anda harus melampirkan kumpulan data.

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 pada Alat Migrasi Data ini.

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 koleksi Anda mengalami batas waktu. Umumnya, Anda dapat mengatasi kesalahan ini dengan menunggu hingga waktu yang kurang sibuk dalam sehari, seperti setelah jam kerja reguler, untuk menjalankan perintah siapkan.

Untuk memecahkan masalah, uji koneksi ID Microsoft Entra dari komputer dan persiapkan mesin. 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 siapkan 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 fase Validasi, Mengatasi templat proses untuk detail tentang mengatasi kesalahan proses umum.

Mengatasi kesalahan validasi kolom

VS403310

Kesalahan ini terjadi ketika sistem mendeteksi inkonsistensi dalam file koleksi. 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 ini menunjukkan adanya konflik nama bidang 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 ini menunjukkan konflik jenis bidang ada antara koleksi lokal Anda dan Layanan Azure DevOps.

Menggunakanwitadmin , Anda hanya dapat mengubah jenis data 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, Anda dapat mengubah jenisnya ke jenis yang diperlukan.

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

Nota

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

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 mengantrekan migrasi, tetapi malah mendapatkan kesalahan. 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 .

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 terpisah.

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 SQL yang disediakan.

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

Tinjau parameter yang Anda berikan untuk memastikan parameter tersebut benar dan coba lagi.

VS403260 &VS403351

Database koleksi belum terlepas.

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.

Lepas database koleksi Anda dan coba antrean migrasi lagi.

VS403261

String koneksi harus dienkripsi, jika tidak, kata sandi dikirim dalam bentuk teks biasa.

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 isn't supported.

Tambahkan Integrated Security=False ke string koneksi SQL Anda.

VS403263

Akun pengguna yang Anda gunakan untuk masuk ke SQL tidak memiliki peran basis data yang diperlukan.

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

Pastikan akun pengguna untuk masuk diberi peran 'TFSEXECROLE'.

Nota

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 mengonfirmasi bahwa identitas Anda memiliki peran, buat identitas baru untuk migrasi Anda.

VS403264

String koneksi tidak mengarah ke database himpunan Azure DevOps Server.

VS403264: The database isn't an Azure DevOps Server Collection database, it can't be used for migration.

Verifikasi atau koreksi string koneksi yang menunjuk ke database koleksi Anda.

VS403255

Pembaruan Azure DevOps Server 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 can't 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

Terdapat karakter baris baru 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 layanan Azure DevOps yang menjadi 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 layanan 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 dalam 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 mereka ke dalam pengecualian firewall Anda dan coba mengantrikan migrasi lagi. Untuk daftar alamat IP, lihat Memigrasikan koleksi besar, batasi akses hanya ke IP Azure DevOps Services.

VS403373

Alat Migrasi Data tidak mendukung migrasi beberapa salinan koleksi SAME. Namun, memang 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 ulang perintah siapkan dan gunakan file migration.json baru untuk mengantre 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 fails as one or more projects found in this collection are in the soft-deleted stage. Please restore the soft-deleted projects or delete them permanently before running the data migration.

Verifikasilah koleksi yang Anda gunakan dengan Alat Migrasi Data dan pastikan bahwa proyek-proyek di dalamnya berada dalam tahap penghapusan sementara. Setelah proyek dihapus, proyek tetap dalam status penghapusan sementara selama 28 hari di mana Anda dapat memulihkan proyek yang dihapus. Anda dapat membaca tentang cara memulihkan proyek yang dihapus di Memulihkan proyek. Jika Anda memiliki proyek dalam tahap penghapusan sementara, hapus sepenuhnya atau pulihkan 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 dalam email dan artikel ini untuk mengatasi kesalahan dan mencoba kembali migrasi Anda.

Jika kesalahan lebih kompleks, email yang Anda terima memberikan instruksi tentang cara mengajukan kasus dukungan pelanggan. Setelah Anda mengajukan kasus dukungan pelanggan, tim Anda harus mengembalikan instans Azure DevOps Server Anda agar kembali online dan memasang ulang koleksi Anda. Anggota tim Anda kemudian dapat terus bekerja. Jangan coba migrasi lagi hingga kegagalan yang menyebabkan masalah teratasi.

Menggunakan AI untuk memecahkan masalah migrasi

Contoh permintaan berikut untuk Copilot Chat membantu Anda memecahkan masalah kesalahan Azure DevOps Data Migration Tool dan masalah migrasi. Salin dan tempel perintah berikut ke Copilot Chat, mengganti placeholder dengan informasi spesifik Anda.

Untuk bantuan AI terbaik, sertakan detail spesifik seperti kode kesalahan yang tepat, fase migrasi di mana kesalahan terjadi, informasi ukuran database, dan detail konfigurasi terkait.

I'm encountering this Azure DevOps migration error: [PASTE YOUR ERROR MESSAGE HERE]

Migration details:
- Error code: [ERROR CODE like VS403###, ISVError:###]
- Migration phase: [VALIDATION/PREPARATION/MIGRATION phase]
- Collection database size: [SIZE IN GB if known]
- Migration method: [DACPAC/SQL Azure VM]
- Azure DevOps Server version: [VERSION like 2019, 2020, 2022]
- Target Azure region: [REGION like East US, West Europe]
- Collation: [DATABASE COLLATION if known]

Can you help me troubleshoot this issue? Please provide step-by-step instructions to:
1. Identify the root cause of the migration error
2. Fix the database, configuration, or migration settings issue
3. Verify the solution allows migration to proceed

Context: This is for migrating from Azure DevOps Server to Azure DevOps Services using the Data Migration Tool. The error might be related to database size, collation, identity permissions, field conflicts, process templates, or connection string issues.

Copilot didukung oleh AI, sehingga kejutan dan kesalahan dimungkinkan. Untuk informasi selengkapnya, lihat FAQ umum untuk Copilot.

Tanya Jawab Umum

T: Apa yang harus saya lakukan jika migrasi saya diantrekan tetapi gagal dan saya tidak menerima email dengan langkah berikutnya?

A: Jika migrasi Anda diantrekan tetapi gagal dan Anda tidak menerima pemberitahuan email, ikuti langkah-langkah berikut:

  • Periksa log migrasi: Tinjau log migrasi untuk pesan kesalahan apa pun yang mungkin menunjukkan penyebab kegagalan. Log dapat memberikan wawasan tentang apa yang salah selama proses migrasi.
  • Ikuti langkah-langkah pemecahan masalah: Lihat langkah-langkah pemecahan masalah yang diuraikan dalam panduan pemecahan masalah migrasi ini. Langkah-langkah ini dapat membantu Anda mengidentifikasi dan menyelesaikan masalah umum yang menyebabkan kegagalan.
  • Hubungi Dukungan Pelanggan: Jika kesalahannya kompleks atau Anda tidak dapat mengatasi masalah dengan menggunakan log dan langkah-langkah pemecahan masalah, pertimbangkan untuk mengajukan kasus dukungan pelanggan untuk bantuan lebih lanjut.
  • Batalkan perubahan dan coba ulang: Jika perlu, batalkan perubahan pada instans Azure DevOps Server Anda dan sambungkan kembali koleksinya sebelum mencoba migrasi lagi.

Konten terkait

  • Last updated on