Kontrol sumber di Azure Data Factory

Azure Data Factory Azure Synapse Analytics

Petunjuk

Data Factory di Microsoft Fabric adalah generasi Azure Data Factory berikutnya, dengan arsitektur yang lebih sederhana, AI bawaan, dan fitur baru. Jika Anda baru menggunakan integrasi data, mulailah dengan Fabric Data Factory. Beban kerja ADF yang ada dapat ditingkatkan ke Fabric untuk mengakses kemampuan baru di seluruh ilmu data, analitik real time, dan pelaporan.

• Mulai uji coba gratis Fabric.
• Mutakhirkan dari Azure Data Factory ke Data Factory di Microsoft Fabric

Secara default, penulis pengalaman antarmuka pengguna (UX) Azure Data Factory langsung terhadap layanan pabrik data. Pengalaman ini memiliki batasan berikut:

• Layanan Data Factory tidak menyertakan repositori untuk menyimpan entitas JSON untuk perubahan Anda. Satu-satunya cara untuk menyimpan perubahan adalah melalui tombol Terbitkan Semua dan semua perubahan akan diterbitkan langsung ke layanan pabrik data.
• Layanan Data Factory tidak dioptimalkan untuk kontrol versi dan kolaborasi.
• Template Azure Resource Manager (ARM) yang diperlukan untuk mendistribusikan Data Factory sendiri tidak termasuk.

Untuk memberikan pengalaman penulisan yang lebih baik, Azure Data Factory memungkinkan Anda mengonfigurasi repositori Git dengan Azure Repos atau GitHub. Git adalah sistem kontrol versi yang memungkinkan kolaborasi dan pelacakan perubahan yang lebih mudah. Artikel ini menjelaskan cara mengonfigurasi dan bekerja di repositori Git serta menyoroti praktik terbaik dan panduan pemecahan masalah.

Anda juga dapat merujuk Integrasi dan Pengiriman Berkelanjutan (CI/CD) di Azure Data Factory untuk mempelajari lebih lanjut tentang pola CI/CD yang lebih besar, di mana pengendalian sumber daya adalah aspek penting.

Catatan

Dukungan publik GitHub kini tersedia di Azure Gov dan Microsoft Azure yang dioperasikan oleh 21Vianet. Untuk informasi lebih lanjut, lihat blog pengumuman.

Untuk mempelajari selengkapnya tentang bagaimana Azure Data Factory terintegrasi dengan Git, lihat video tutorial 15 menit di bawah ini:

Keuntungan integrasi Git

Berikut adalah daftar beberapa keuntungan yang diberikan integrasi Git terhadap pengalaman penulisan:

• Kontrol sumber: Saat beban kerja pabrik data Anda menjadi penting, Anda ingin mengintegrasikan pabrik Anda dengan Git untuk menerapkan beberapa manfaat kontrol sumber seperti berikut:
  • Kemampuan untuk melacak/mengaudit perubahan.
  • Kemampuan untuk mengembalikan perubahan yang menyebabkan bug.
• Penyimpanan parsial: Saat menulis terhadap layanan pabrik data, Anda tidak dapat menyimpan perubahan sebagai draf, dan semua penerbitan harus melewati validasi pabrik data. Apakah pipeline Anda belum selesai atau Anda tidak ingin kehilangan perubahan jika komputer Anda crash, integrasi Git memungkinkan perubahan bertahap pada sumber daya pabrik data tanpa memandang status tersebut. Mengonfigurasi repositori Git memungkinkan Anda menyimpan perubahan, sehingga Anda hanya mempublikasikan setelah menguji perubahan sesuai kepuasan Anda.
• Kolaborasi dan kontrol: Jika Anda memiliki beberapa anggota tim yang berkontribusi pada pabrik yang sama, Anda mungkin ingin membiarkan rekan satu tim berkolaborasi satu sama lain melalui proses peninjauan kode. Anda juga dapat mengatur pabrik Anda agar tidak semua kontributor memiliki izin yang sama. Beberapa anggota tim mungkin hanya diizinkan untuk membuat perubahan melalui Git dan hanya orang-orang tertentu dalam tim yang diizinkan untuk menerbitkan perubahan ke pabrik.
• CI/CD yang lebih baik: Jika Anda menerapkan ke beberapa lingkungan dengan proses pengiriman yang berkelanjutan, integrasi Git membuat beberapa tindakan menjadi lebih mudah. Beberapa tindakan ini meliputi:
  • Konfigurasikan pipeline rilis Anda untuk memicu secara otomatis segera setelah ada perubahan yang dilakukan pada fabrikasi 'dev' Anda.
  • Sesuaikan properti di pabrik Anda yang tersedia sebagai parameter di templat Resource Manager. Ini dapat berguna untuk menyimpan hanya sekumpulan properti yang diperlukan sebagai parameter, dan memiliki segala sesuatu yang lain yang dikodekan secara permanen.
• Performa Lebih Baik: Rata-rata pabrik dengan integrasi Git memuat 10 kali lebih cepat daripada satu pembuatan terhadap layanan pabrik data. Peningkatan performa ini karena sumber daya diunduh melalui Git.

Catatan

Penulisan langsung dengan layanan Data Factory dinonaktifkan di UX Azure Data Factory saat repositori Git dikonfigurasi. Perubahan yang dilakukan melalui PowerShell atau SDK dipublikasikan langsung ke layanan Data Factory dan tidak dimasukkan ke Git.

Menyambungkan ke repositori Git

Ada empat cara berbeda untuk menghubungkan repositori Git ke pabrik data Anda untuk Azure Repos dan GitHub. Setelah tersambung ke repositori Git, Anda dapat melihat dan mengelola konfigurasi di hub manajemen di bawah konfigurasi Git di bagian kontrol sumber.

Metode konfigurasi 1: Beranda

Di beranda Azure Data Factory, pilih Siapkan repositori kode di bagian atas.

Metode konfigurasi 2: Kanvas penulisan

Di kanvas penulisan UX Azure Data Factory, pilih menu drop-down Data Factory, lalu pilih Siapkan repositori kode.

Metode konfigurasi 3: Hub pengelolaan

Buka hub manajemen di Azure Data Factory Studio. Pilih Konfigurasi git di bagian Kontrol sumber. Jika Anda tidak memiliki repositori yang tersambung, pilih Konfigurasikan.

Metode konfigurasi 4: Saat pembuatan pabrik

Saat membuat pabrik data baru di portal Azure, Anda dapat mengonfigurasi informasi repositori Git di tab konfigurasi Git.

Catatan

Saat mengonfigurasi Git di portal Azure, pengaturan seperti nama proyek dan nama repo harus dimasukkan secara manual daripada menjadi bagian dari dropdown.

Penulis dengan integrasi Git pada Azure Repos

Penulisan visual dengan integrasi git Azure Repos mendukung kontrol sumber dan kolaborasi untuk bekerja pada alur pabrik data Anda. Anda dapat mengaitkan pabrik data dengan repositori organisasi Git Azure Repos untuk kontrol sumber, kolaborasi, penerapan versi, dan sebagainya. Satu organisasi git Azure Repos dapat memiliki beberapa repositori, tetapi repositori Git Azure Repos hanya dapat dikaitkan dengan satu pabrik data. Jika Anda tidak memiliki organisasi atau repositori Azure Repos, ikuti instruksi untuk membuat sumber daya Anda.

Catatan

Anda dapat menyimpan file skrip dan data di repositori Git Azure Repos. Namun, Anda harus mengunggah file secara manual ke Azure Storage. Alur pabrik data tidak secara otomatis mengunggah skrip atau file data yang disimpan di repositori Git Azure Repos untuk Azure Storage. File tambahan seperti templat ARM, skrip, atau file konfigurasi, dapat disimpan di repositori di luar folder yang dipetakan. Jika Anda melakukan ini, perlu diingat bahwa tugas tambahan diperlukan untuk membangun/menyebarkan dan berinteraksi dengan file yang disimpan di luar folder Azure DevOps yang dipetakan.

pengaturan Azure Repos

Panel konfigurasi menuntun Anda langkah demi langkah untuk mengonfigurasi pengaturan repositori kode berikut ini:

Pengaturan	Deskripsi	Nilai
Jenis Repositori	Jenis repositori kode Azure Repos.	Azure DevOps Git atau GitHub
Microsoft Entra ID	Nama penyewa Microsoft Entra Anda.	<your tenant name>
Azure Repos Organization	Nama organisasi Azure Repos Anda. Anda dapat menemukan nama organisasi Azure Repos Anda di https://{organization name}.visualstudio.com. Anda dapat sign ke organisasi Azure Repos Anda untuk mengakses profil Visual Studio Anda dan melihat repositori dan proyek Anda.	<your organization name>
ProjectName	Nama proyek Azure Repos Anda. Anda dapat menemukan nama proyek Azure Repos Anda di https://{organization name}.visualstudio.com/{project name}.	<your Azure Repos project name>
RepositoryName	Nama repositori kode Azure Repos Anda. Azure Repos proyek berisi repositori Git untuk mengelola kode sumber Anda saat proyek Anda tumbuh. Anda dapat membuat repositori baru atau menggunakan repositori yang sudah ada di proyek Anda.	<your Azure Repos code repository name>
Cabang kolaborasi	Cabang kolaborasi repositori Azure Anda yang digunakan untuk publikasi. Secara default, ini adalah main. Ubah pengaturan ini jika Anda ingin menerbitkan sumber daya dari cabang lain.	<your collaboration branch name>
Cabang penerbitan	Cabang penerbitan adalah cabang di repositori Anda tempat template ARM terkait penerbitan disimpan dan diperbarui. Secara default, ini adalah adf_publish.	<your publish branch name>
Direktori root	Folder akar Anda di cabang kolaborasi Azure Repos Anda.	<your root folder name>
Mengimpor sumber daya Data Factory yang ada ke repositori	Menentukan apakah akan mengimpor sumber daya Data Factory yang ada dari kanvas UX Authoring canvas ke repositori Git Azure Repos. Pilih kotak untuk mengimpor sumber daya pabrik data Anda ke dalam repositori Git terkait dalam format JSON. Tindakan ini mengekspor setiap sumber daya secara individual (artinya, layanan dan himpunan data yang ditautkan diekspor ke JSON terpisah). Saat kotak ini tidak dipilih, sumber daya yang ada tidak diimpor.	Dipilih (default)
Cabang untuk mengimpor sumber daya ke dalamnya	Menentukan ke cabang mana sumber daya pabrik data (alur, himpunan data, layanan tertaut, dll.) diimpor. Anda bisa mengimpor sumber daya ke salah satu cabang berikut: a. Kolaborasi b. Buat yang baru c. Gunakan yang ada

Catatan

Jika Anda menggunakan Microsoft Edge dan tidak melihat nilai apa pun di dropdown Akun Azure DevOps Anda, tambahkan https://*.visualstudio.com ke daftar situs tepercaya.

Mengedit pengaturan repositori

Jika ada penyesuaian yang perlu dilakukan pada pengaturan repositori Git Azure Repos yang dikonfigurasi, Anda dapat memilih untuk Edit.

Anda dapat memperbarui cabang penerbitan dan memutuskan apakah akan menonaktifkan tombol terbitkan atau tidak dari studio ADF. Jika Anda memilih untuk menonaktifkan tombol terbitkan dari studio, tombol terbitkan berwarna abu-abu di studio. Ini membantu Anda menghindari penimpaan penyebaran penerbitan otomatis terakhir.

Gunakan tenant Microsoft Entra yang berbeda

Repositori Git Azure Repos dapat berada di penyewa Microsoft Entra yang berbeda. Untuk menentukan penyewa Microsoft Entra yang berbeda, Anda harus memiliki izin administrator untuk langganan Azure yang Anda gunakan. Untuk informasi selengkapnya, lihat mengubah administrator langganan.

Penting

Untuk menyambungkan ke Microsoft Entra ID lain, pengguna yang masuk harus menjadi bagian dari direktori aktif tersebut.

Gunakan akun Microsoft pribadi Anda

Untuk menggunakan akun Microsoft pribadi untuk integrasi Git, Anda dapat menautkan Azure Repo pribadi anda ke Direktori Aktif organisasi Anda.

1. Tambahkan akun Microsoft pribadi Anda ke Direktori Aktif organisasi Anda sebagai tamu. Untuk informasi selengkapnya, lihat Tambahkan pengguna kolaborasi B2B Microsoft Entra di portal Azure.

2. Masuk ke portal Azure dengan akun Microsoft pribadi Anda. Kemudian beralihlah ke Direktori Aktif organisasi Anda.

3. Buka bagian Azure DevOps, tempat Anda sekarang melihat repositori pribadi Anda. Pilih repositori dan sambungkan dengan Direktori Aktif.

Setelah langkah-langkah konfigurasi ini, repositori pribadi Anda tersedia saat Anda mengatur integrasi Git di UI Data Factory.

Untuk informasi selengkapnya tentang menyambungkan Azure Repos ke Direktori Aktif organisasi Anda, lihat Sambungkan organisasi Azure DevOps Anda ke Microsoft Entra ID.

Penulis dengan integrasi GitHub

Penulisan visual dengan integrasi GitHub mendukung kontrol sumber dan kolaborasi untuk bekerja pada alur pabrik data Anda. Anda dapat mengaitkan pabrik data dengan repositori akun GitHub untuk kontrol sumber, kolaborasi, penerapan versi. Satu akun GitHub dapat menghosting beberapa repositori, dan setiap repositori dapat dikaitkan dengan beberapa pabrik data. Dengan mengonfigurasi setiap pabrik data untuk menggunakan cabang yang berbeda dalam repositori yang sama, Anda dapat mempertahankan lingkungan terpisah (seperti pengembangan, penahapan, dan produksi) sambil mengelola konfigurasinya secara independen. Jika Anda tidak memiliki akun atau repositori GitHub, ikuti instruksi untuk membuat sumber daya Anda.

Integrasi GitHub dengan Data Factory mendukung GitHub publik (yaitu, https://github.com), GitHub Enterprise Cloud dan GitHub Enterprise Server. Anda dapat menggunakan repositori GitHub publik dan privat dengan Data Factory selama Anda memiliki izin baca dan tulis ke repositori di GitHub. Untuk menyambungkan dengan Repositori Publik, pilih Gunakan Repositori Tautan, karena tidak terlihat di menu dropdown untuk Nama Repositori. Integrasi server enterprise GitHub ADF hanya berfungsi dengan versi server enterprise GitHub yang didukung secara resmi.

Untuk repositori yang dimiliki oleh akun organisasi GitHub, admin harus mengotorisasi aplikasi ADF. Untuk repositori yang dimiliki oleh akun pengguna GitHub, pengguna dengan setidaknya izin kolaborator dapat mengotorisasi aplikasi ADF. Izin ini tidak memberikan akses langsung aplikasi ADF ke semua repositori yang dimiliki oleh akun/organisasi, hanya memungkinkan aplikasi ADF untuk bertindak atas nama pengguna untuk mengakses repositori berdasarkan izin akses pengguna.

Catatan

Jika Anda menggunakan Microsoft Edge, GitHub Enterprise versi kurang dari 2.1.4 tidak berfungsi dengannya. GitHub secara resmi mendukung >=3.0 dan semuanya harus baik-baik saja untuk ADF. Saat GitHub mengubah versi minimumnya, versi yang didukung ADF juga berubah.

pengaturan GitHub

Catatan

Jika Anda mengalami kesalahan Failed untuk mencantumkan repositori GitHub. Pastikan nama akun sudah benar dan Anda memiliki izin untuk melakukan action., pastikan Anda menggunakan nama pemilik yang benar, dan bukan URL repositori GitHub.

Panel konfigurasi memperlihatkan pengaturan repositori GitHub berikut:

Pengaturan	Deskripsi	Nilai
Jenis Repositori	Jenis repositori kode.	GitHub
Gunakan GitHub Enterprise Server	Kotak centang untuk memilih GitHub Enterprise Server.	tidak dipilih (default)
GitHub URL Server Perusahaan	URL akar perusahaan GitHub (harus HTTPS untuk server GitHub Enterprise lokal). Misalnya: https://github.mydomain.com. Diperlukan hanya jika Gunakan GitHub Enterprise Server dipilih	<your GitHub Enterprise Server URL>
GitHub pemilik repositori	organisasi atau akun GitHub yang memiliki repositori. Nama ini dapat ditemukan dari https://github.com/{owner}/{repository nama}. Menavigasi ke halaman ini meminta Anda untuk memasukkan kredensial OAuth GitHub ke organisasi atau akun GitHub Anda. Jika Anda memilih Gunakan GitHub Enterprise Server, kotak dialog akan muncul untuk memungkinkan Anda memasukkan token akses Anda.	<your GitHub repository owner name>
Nama Repositori	Nama repositori kode GitHub Anda. GitHub akun berisi repositori Git untuk mengelola kode sumber Anda. Anda dapat membuat repositori baru atau menggunakan repositori yang sudah ada di akun Anda. Tentukan nama repositori kode GitHub Saat Anda memilih Pilih repositori.	<your repository name>
Tautan repositori Git	Tautan repositori kode GitHub Anda. Tentukan tautan repositori kode GitHub Saat Anda memilih Gunakan tautan repositori.	<your repository link>
Cabang kolaborasi	Cabang kolaborasi GitHub Anda yang digunakan untuk penerbitan. Secara default, itu 'main'. Ubah pengaturan ini jika Anda ingin menerbitkan sumber daya dari cabang lain. Anda juga dapat membuat cabang kolaborasi baru di sini.	<your collaboration branch>
Cabang penerbitan	Cabang di repositori Anda tempat templat ARM terkait penerbitan disimpan dan diperbarui.	<your publish branch name>
Direktori root	Folder akar Anda di cabang kolaborasi GitHub Anda.	<your root folder name>
Impor sumber daya yang ada ke repositori	Menentukan apakah akan mengimpor sumber daya pabrik data yang ada dari kanvas penulisan UX ke dalam repositori GitHub. Pilih kotak untuk mengimpor sumber daya pabrik data Anda ke dalam repositori Git terkait dalam format JSON. Tindakan ini mengekspor setiap sumber daya secara individual (artinya, layanan dan himpunan data yang ditautkan diekspor ke JSON terpisah). Saat kotak ini tidak dipilih, sumber daya yang ada tidak diimpor.	Dipilih (default)
Impor sumber daya ke cabang ini	Menentukan ke cabang mana sumber daya pabrik data (alur, himpunan data, layanan tertaut, dll.) diimpor.

Mengedit pengaturan repositori

Jika ada penyesuaian yang perlu dilakukan pada pengaturan repositori GitHub yang dikonfigurasi, Anda dapat memilih untuk Edit.

Anda dapat memperbarui cabang penerbitan dan memutuskan apakah akan menonaktifkan tombol terbitkan atau tidak dari studio ADF. Jika Anda memilih untuk menonaktifkan tombol terbitkan dari studio, tombol terbitkan berwarna abu-abu di studio. Ini membantu menghindari penimpaan penyebaran penerbitan otomatis terakhir.

organisasi GitHub

Menyambungkan ke organisasi GitHub mengharuskan organisasi memberikan izin ke Azure Data Factory. Pengguna dengan izin ADMIN pada organisasi harus melakukan langkah-langkah di bawah ini agar data factory dapat terhubung.

Menghubungkan ke GitHub publik atau GitHub Cloud Enterprise untuk pertama kalinya di Azure Data Factory

Jika Anda tersambung ke GitHub publik atau GitHub Enterprise Cloud dari Azure Data Factory untuk pertama kalinya, ikuti langkah-langkah ini untuk menyambungkan ke organisasi GitHub.

1. Di panel konfigurasi Git, masukkan nama organisasi di bidang akun GitHub. Muncul petunjuk untuk masuk ke GitHub.
2. Masuk menggunakan kredensial pengguna Anda.
3. Anda diminta untuk mengotorisasi Azure Data Factory sebagai aplikasi bernama AzureDataFactory. Di layar ini, Anda akan melihat opsi untuk memberikan izin bagi ADF untuk mengakses organisasi. Jika Anda tidak melihat opsi untuk memberikan izin, minta admin untuk memberikan izin secara manual melalui GitHub.

Setelah Anda mengikuti langkah-langkah ini, pabrik Anda dapat terhubung ke repositori publik dan privat dalam organisasi Anda. Jika Anda tidak dapat tersambung, coba hapus cache browser dan coba lagi.

Sudah tersambung ke GitHub publik atau GitHub Enterprise Cloud menggunakan akun pribadi

Jika Anda sudah tersambung ke GitHub publik atau GitHub Enterprise Cloud dan hanya memberikan izin untuk mengakses akun pribadi, ikuti langkah-langkah di bawah ini untuk memberikan izin kepada organisasi.

1. Buka GitHub dan buka Settings.

   

2. Pilih Aplikasi. Di tab Aplikasi OAuth resmi, Anda akan melihat AzureDataFactory.

   

3. Pilih aplikasi dan berikan akses aplikasi ke organisasi Anda.

   

Setelah Anda mengikuti langkah-langkah ini, pabrik Anda dapat terhubung ke repositori publik dan privat dalam organisasi Anda.

Menyambungkan ke GitHub Enterprise Server

Jika Anda tersambung ke GitHub Enterprise Server, Anda perlu menggunakan token akses pribadi untuk autentikasi. Pelajari cara membuat token akses pribadi dalam Membuat token akses pribadi.

Catatan

GitHub Enterprise Server berada di lingkungan privat yang dihost sendiri, jadi Anda memerlukan kontrol penuh atas firewall, kebijakan jaringan, dan VPN saat Anda menggunakan autentikasi ini. Untuk informasi selengkapnya, lihat Tentang GitHub Enterprise Server.

Batasan GitHub yang diketahui

• Anda dapat menyimpan file skrip dan data di repositori GitHub. Namun, Anda harus mengunggah file secara manual ke Azure Storage. Alur Data Factory tidak secara otomatis mengunggah skrip atau file data yang disimpan di repositori GitHub untuk Azure Storage.

• GitHub Enterprise dengan versi yang lebih lama dari 2.14.0 tidak berfungsi di browser Microsoft Edge.

• Integrasi GitHub dengan alat penulisan visual Data Factory hanya berfungsi pada versi Data Factory yang tersedia umum.

Menyambungkan ke Azure DevOps Server 2022

Jika Anda tersambung ke Azure DevOps Server 2022, Anda perlu menggunakan token akses pribadi untuk autentikasi. Pelajari cara membuat token akses pribadi di sini.

Sambungkan ke Azure DevOps lokal dengan menyediakan Azure DevOps Server URL dan Azure DevOps Project Collection

Berikan token dengan cakupan akses sebagai baca/tulis untuk kode.

Pengendalian versi

Sistem kontrol versi (juga dikenal sebagai kontrol sumber) memungkinkan pengembang berkolaborasi pada kode dan melacak perubahan yang dibuat di dasar kode. Kontrol sumber adalah alat penting untuk proyek multi-pengembang.

Membuat cabang fitur

Setiap repositori Git Azure Repos yang terkait dengan pabrik data memiliki cabang kolaborasi. (main adalah cabang kolaborasi default). Pengguna juga dapat membuat cabang fitur dengan memilih + Cabang Baru di dropdown cabang.

Setelah panel cabang baru muncul, masukkan nama cabang fitur Anda dan pilih cabang yang menjadi dasar pekerjaan.

Saat Anda siap menggabungkan perubahan dari cabang fitur ke cabang kolaborasi, pilih pada dropdown cabang dan pilih Buat permintaan tarik. Tindakan ini membawa Anda untuk Azure Repos Git tempat Anda dapat mengajukan permintaan pull, melakukan tinjauan kode, dan menggabungkan perubahan ke cabang kolaborasi Anda. (main adalah defaultnya). Anda hanya diizinkan untuk menerbitkan ke layanan Data Factory dari cabang kolaborasi Anda.

Mengonfigurasi pengaturan penerbitan

Secara default, pabrik data menghasilkan templat Resource Manager pabrik yang diterbitkan dan menyimpannya ke dalam cabang yang disebut adf_publish. Untuk mengonfigurasi cabang penerbitan kustom, tambahkan file publish_config.json ke folder akar di cabang kolaborasi. Saat menerbitkan, ADF membaca file ini, mencari bidang publishBranch, dan menyimpan semua templat Resource Manager ke lokasi yang ditentukan. Jika cabang tidak ada, Data Factory akan membuatnya secara otomatis. Contoh seperti apa file ini di bawah ini:

{
    "publishBranch": "factory/adf_publish"
}

Azure Data Factory hanya dapat memiliki satu cabang penerbitan pada satu waktu. Saat Anda menentukan cabang penerbitan baru, Data Factory tidak menghapus cabang penerbitan sebelumnya. Jika Anda ingin menghapus cabang penerbitan sebelumnya, hapus secara manual.

Catatan

Data Factory hanya membaca file publish_config.json ketika memuat factory. Jika Anda sudah memuat pabrik di portal, refresh browser agar perubahan diterapkan.

Menerbitkan perubahan kode

Setelah Anda menggabungkan perubahan pada cabang kolaborasi (main adalah default), pilih Publikasikan untuk mempublikasikan secara manual perubahan kode Anda di cabang utama ke layanan Data Factory.

Panel samping akan terbuka, di mana Anda mengonfirmasi bahwa cabang publikasi dan perubahan yang tertunda sudah benar. Setelah Anda memverifikasi perubahan, pilih OK untuk mengonfirmasi penerbitan.

Penting

Cabang utama tidak mewakili apa yang diterapkan di layanan Data Factory. Cabang utama harus diterbitkan secara manual ke layanan Data Factory.

Praktik terbaik untuk integrasi Git

Hak Akses

Biasanya Anda tidak ingin setiap anggota tim memiliki izin untuk memperbarui Data Factory. Pengaturan izin berikut direkomendasikan:

• Semua anggota tim harus memiliki izin baca di dalam Data Factory.
• Hanya sekumpulan orang yang dapat diperbolehkan menerbitkan ke Data Factory. Untuk melakukannya, mereka harus memiliki peran kontributor Data Factory di Grup Sumber Daya yang berisi Data Factory. Untuk informasi selengkapnya tentang izin, lihat Roles dan izin untuk Azure Data Factory.

Sebaiknya jangan izinkan masuk langsung ke cabang kolaborasi. Pembatasan ini dapat membantu mencegah bug karena setiap check-in akan melalui proses ulasan permintaan pull yang dijelaskan dalam Membuat cabang fitur.

Menggunakan kata sandi dari Azure Key Vault

Disarankan untuk menggunakan Azure Key Vault untuk menyimpan string koneksi atau kata sandi atau autentikasi identitas terkelola untuk Data Factory Linked Services. Untuk alasan keamanan, pabrik data tidak menyimpan rahasia di Git. Setiap perubahan pada Layanan Tertaut yang berisi rahasia seperti kata sandi segera diterbitkan ke layanan Azure Data Factory.

Menggunakan Key Vault atau autentikasi identitas terkelola juga memudahkan integrasi dan penerapan berkelanjutan karena Anda tidak perlu memberikan rahasia ini selama penerapan template Resource Manager.

Pemecahan masalah integrasi Git

Cabang terbitan kedaluwarsa

Di bawah ini adalah beberapa contoh situasi yang dapat menyebabkan cabang terbitan kedaluwarsa:

• Pengguna memiliki beberapa cabang. Di salah satu cabang fitur, mereka menghapus layanan yang terhubung yang tidak terkait dengan Azure Key Vault (AKV) (layanan yang tidak terhubung AKV langsung dipublikasikan terlepas dari apakah mereka berada di Git) dan tidak pernah menggabungkan cabang fitur tersebut ke dalam cabang kolaborasi.
• Pengguna memodifikasi pabrik data menggunakan SDK atau PowerShell
• Pengguna memindahkan semua sumber daya ke cabang baru dan mencoba menerbitkan untuk pertama kalinya. Layanan tertaut harus dibuat secara manual saat mengimpor sumber daya.
• Pengguna mengunggah layanan tertaut non-AKV atau JSON Integration Runtime secara manual. Mereka merujuk sumber daya tersebut dari sumber daya lain seperti himpunan data, layanan tertaut, atau alur. Layanan tertaut non-AKV yang dibuat melalui antarmuka pengguna langsung diterbitkan karena kredensial perlu dienkripsi. Jika Anda mengunggah dataset yang merujuk pada layanan yang terhubung tersebut dan mencoba mempublikasikannya, antarmuka pengguna mengizinkannya karena data tersebut ada di lingkungan Git. Aplikasi ini akan ditolak saat dipublikasikan karena tidak ada di layanan pabrik data.

Jika cabang penerbitan tidak sinkron dengan cabang utama dan berisi sumber daya kedaluwarsa meskipun ada peberbitan baru-baru ini, Anda dapat menggunakan salah satu dari solusi di bawah ini:

Opsi 1: Gunakan fungsi mode live Overwrite

Opsi ini menerbitkan atau menimpa kode dari cabang kolaborasi Anda ke mode langsung. Ini menganggap kode di repositori Anda sebagai sumber kebenaran.

Alur kode:Cabang kolaborasi -> Mode langsung

Opsi 2: Memutuskan dan menyambungkan kembali repositori Git

Opsi ini mengimpor kode dari mode langsung ke cabang kolaborasi. Ini menganggap kode dalam mode langsung sebagai sumber kebenaran.

Alur kode:Mode Aktif -> Cabang Kerjasama

1. Hapus repositori Git Anda saat ini
2. Ganti konfigurasi Git dengan pengaturan yang sama, tetapi pastikan Impor sumber daya Data Factory yang ada ke repositori dipilih dan pilih Cabang kolaborasi (cabang yang sama)
3. Buat pull request untuk menggabungkan perubahan ke cabang kolaborasi.

Catatan

Hanya perlu membuat dan menggabungkan pull request jika Anda bekerja di repositori yang tidak mengizinkan commit langsung. Di sebagian besar organisasi, pengiriman ke repositori memerlukan tinjauan sebelum penggabungan sehingga praktik terbaik biasanya adalah menggunakan pendekatan ini. Namun, dalam beberapa kasus tidak diperlukan peninjauan, dalam hal ini tidak perlu membuat dan menggabungkan pull request, tetapi perubahan dapat langsung di-commit ke cabang kolaborasi.

Pilih salah satu metode dengan tepat sesuai kebutuhan.

Semua sumber daya ditampilkan sebagai baru di publikasi

Saat menerbitkan, semua sumber daya mungkin ditampilkan sebagai baru meskipun sebelumnya diterbitkan. Hal ini bisa terjadi jika properti lastCommitId diatur ulang ke properti repoConfiguration pabrik dengan menyebarkan ulang template ARM pabrik atau memperbarui properti repoConfiguration pabrik melalui PowerShell atau REST API. Melanjutkan penerbitan sumber daya dapat menyelesaikan masalah, tetapi untuk mencegahnya terjadi lagi, hindari memperbarui properti repoConfiguration pabrik.

Beralih ke repositori Git yang berbeda

Untuk beralih ke repositori Git lain, masuk ke halaman konfigurasi Git di hub pengelolaan di Kontrol sumber. Pilih Putuskan koneksi.

Masukkan nama pabrik data Anda dan pilih konfirmasi untuk menghapus repositori Git yang terkait dengan pabrik data Anda.

Setelah menghapus kaitan dengan repositori saat ini, Anda dapat mengonfigurasi pengaturan Git untuk menggunakan repositori lain, lalu mengimpor sumber daya Data Factory yang sudah ada ke repositori baru itu.

Penting

Menghapus konfigurasi Git dari pabrik data tidak menghapus apa pun dari repositori. Pabrik berisi semua sumber daya yang diterbitkan. Anda dapat terus mengedit pabrik secara langsung di layanan.

Konten terkait

• Untuk mempelajari selengkapnya tentang memantau dan mengelola alur, lihat Memantau dan mengelola alur secara terprogram.
• Untuk menerapkan integrasi dan penyampaian berkelanjutan, lihat Integrasi dan penyampaian kontinu (CI/CD) di Azure Data Factory.