Membuat aplikasi menggunakan DevOps dan API GraphQL

Artikel
11/19/2024

Berlaku untuk:✅Database SQL di Microsoft Fabric

Di bagian tutorial ini, Anda akan menggunakan aset yang telah Anda buat untuk membuat aplikasi web yang memungkinkan pengguna memilih wilayah yang terpengaruh oleh pemadaman, lalu melihat pemasok lain di wilayah tersebut, untuk memperingatkan perusahaan tentang gangguan rantai pasokan lebih lanjut. Anda akan membuat titik akhir GraphQL atas data Anda, lalu membuat aplikasi ASP.NET yang dapat Anda sebarkan secara lokal atau ke penyedia cloud.

Proyek pengembangan perangkat lunak melibatkan tugas Operasi Pengembang (DevOps), salah satunya adalah kontrol sumber. Anda akan memulai bagian ini dengan menempatkan item yang telah Anda buat di bawah kontrol sumber.

Artikel ini menyajikan serangkaian skenario yang berguna untuk membuat aplikasi berdasarkan database SQL di Fabric.

Prasyarat

Selesaikan semua langkah sebelumnya dalam tutorial ini.
Aktifkan pengaturan penyewa integrasi Git.
Aktifkan Pengaturan Admin Penyewa untuk API untuk GraphQL.
Membuat Organisasi dan Proyek di Microsoft Azure DevOps.

CI/CD in Fabric dengan Azure DevOps

Di bagian tutorial ini, Anda akan mempelajari cara bekerja dengan database SQL Anda di Microsoft Fabric dengan Azure DevOps.

Database SQL di Microsoft Fabric memiliki integrasi kontrol sumber yang memungkinkan pengguna SQL melacak definisi objek database mereka dari waktu ke waktu dan di seluruh tim:

Tim dapat menerapkan database ke kontrol sumber, yang secara otomatis mengonversi database langsung menjadi kode di repositori kontrol sumber yang dikonfigurasi (Azure DevOps).
Tim dapat memperbarui objek database dari konten kontrol sumber, yang memvalidasi kode di Azure DevOps sebelum menerapkan perubahan diferensial ke database.

Jika Anda tidak terbiasa dengan kontrol kode sumber di Microsoft Fabric, berikut adalah sumber daya yang direkomendasikan:

Tutorial: Manajemen siklus hidup di Fabric

Mulai menggunakan kontrol sumber

Setelah menyelesaikan prasyarat ini, Anda dapat menjaga ruang kerja Anda tetap sinkron dengan Azure DevOps. Ini memungkinkan Anda untuk menerapkan perubahan apa pun yang Anda buat di ruang kerja ke cabang Azure DevOps, dan memperbarui ruang kerja Anda setiap kali siapa pun membuat penerapan baru ke cabang Azure DevOps.

Sekarang Anda akan mengedit salah satu objek di database Anda menggunakan Azure DevOps yang akan memperbarui repositori dan objek database. Anda juga dapat mengedit objek langsung di repositori atau "mendorong" objek di sana, tetapi dalam hal ini melakukan semua langkah di lingkungan Azure DevOps Anda.

Dalam tampilan Ruang Kerja tutorial Anda, pastikan ruang kerja Anda disiapkan berada di bawah kontrol sumber dan semua objek menampilkan Disinkronkan.
Dalam tampilan Ruang Kerja, Anda akan melihat ikon git, cabang yang Anda pilih, dan pesan tentang terakhir kali Ruang Kerja disinkronkan dengan kontrol sumber. Di samping tanggal dan waktu, Anda akan melihat tautan pengidentifikasi untuk lokasi tertentu di lingkungan Azure DevOps Anda. Buka tautan tersebut untuk melanjutkan.
Masuk ke lingkungan Azure DevOps Anda jika diminta.
Setelah berada di dalam lingkungan Azure DevOps, pilih item File di panel penjelajah. Objek yang disinkronkan dengan database SQL Anda di Fabric dan repositori ditampilkan.
Perluas suppy_chain_analytics_database. SQLDatabase, lalu dbo, lalu Tabel lalu Suppliers.sql objek.

Perhatikan definisi T-SQL tabel dalam konten objek. Dalam lingkungan pengodean produksi, objek ini akan diubah menggunakan alat pengembangan seperti Visual Studio, atau Visual Studio Code. Bagaimanapun, definisi objek database tersebut direplikasi ke repositori, yang Anda cerminkan dari status database saat ini. Mari kita gunakan kontrol sumber Azure DevOps untuk membuat beberapa perubahan pada objek database dalam langkah-langkah tutorial berikutnya.

[Fax] Temukan baris definisi kolom dan pilih tombol Edit. Edit definisi kolom ke [Fax] NVARCHAR (255) NULL,.
Pilih tombol Terapkan .
Isi kotak Terapkan pesan yang muncul dan pilih tombol Terapkan . Cobalah untuk mendeskripsikan setiap perubahan dalam kontrol sumber, untuk keuntungan Anda dan tim Anda.
Penerapan menulis perubahan ke repositori.
Beralih kembali ke database SQL di portal Fabric, lalu pilih Kontrol Sumber.
Anda memiliki satu pembaruan tertunda. Dalam produksi, Anda akan meninjau perubahan ini. Pilih tombol Perbarui Semua . Pembaruan mungkin memakan waktu.
Pilih database SQL dalam nama Fabric. Buka jendela kueri baru di database SQL Anda.
Salin dan tempel kode T-SQL berikut untuk melihat perubahan pada tabel secara langsung di database:
```
SELECT * FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_NAME = 'Suppliers';
```
Masukkan kode T-SQL berikut yang meminta untuk menambahkan kolom bernama Notes ke Suppliers tabel. Sorot hanya bagian kode tersebut dan pilih tombol Jalankan :
```
ALTER TABLE Suppliers ADD Notes NVARCHAR(MAX);
```
Sekarang kembali ke ruang kerja tutorial di portal Fabric.
Pilih tombol Kontrol Sumber dan perhatikan bahwa daripada Pembaruan, sistem Anda menampilkan permintaan Perubahan . Pilih kotak centang di samping nama objek lalu pilih tombol Terapkan.
Sistem menerapkan perubahan yang dibuat di editor kueri, dan Anda dapat kembali ke Portal Azure DevOps dan menavigasi ke area File dan dbo Skema lalu Tabel dan Suppliers objek untuk melihat kolom baru. (Anda mungkin perlu me-refresh halaman untuk melihat perubahan.)

Sekarang Anda telah melihat bagaimana Anda dapat berinteraksi dengan skema objek database SQL dari kontrol sumber Anda di Azure DevOps. Untuk informasi selengkapnya tentang kontrol sumber di Microsoft Fabric, lihat Integrasi kontrol sumber database SQL di Microsoft Fabric dan Tutorial: Manajemen siklus hidup di Fabric.

Menyiapkan dan mengonfigurasi API GraphQL

Menyambungkan ke aplikasi database sering melibatkan penginstalan sekumpulan pustaka untuk aplikasi Anda yang menggunakan protokol Tabular Data Stream (TDS) yang berinteraksi langsung dengan database.

Microsoft Fabric menyertakan antarmuka GraphQL untuk bekerja tidak hanya dengan database, tetapi dengan beberapa sumber data. Anda juga dapat menggabungkan sumber ini untuk tampilan data terintegrasi. GraphQL adalah bahasa kueri untuk API yang memungkinkan Anda meminta data yang Anda butuhkan dengan tepat, sehingga lebih mudah untuk mengembangkan API dari waktu ke waktu dan mengaktifkan alat pengembang yang kuat. Ini memberikan deskripsi data yang lengkap dan dapat dimengerti di API Anda, memberi klien kekuatan untuk meminta apa yang mereka butuhkan dan tidak lebih. Ini membuat aplikasi menggunakan GraphQL cepat dan stabil karena mengontrol data yang mereka dapatkan, bukan server. Anda dapat menganggap antarmuka GraphQL sebagai menyediakan tampilan sekumpulan data yang terkandung dalam sumber data. Anda bisa mengkueri data dan mengubah data menggunakan mutasi. Anda dapat mempelajari lebih lanjut tentang GraphQL pada referensi ini.

Anda dapat mulai membangun API GraphQL langsung dari dalam editor kueri Fabric SQL. Fabric membangun skema GraphQL secara otomatis berdasarkan data Anda, dan aplikasi siap untuk terhubung dalam hitungan menit.

Membuat API untuk GraphQL

Untuk membuat API untuk GraphQL yang akan Anda gunakan untuk aplikasi:

Buka portal database tutorial.
Pilih tombol Baru dan pilih API untuk GraphQL.
Masukkan teks supplier_impact_gql untuk Nama untuk item Anda dan pilih Buat.
Anda disajikan dengan panel Pilih Data . Gulir hingga Anda menemukan SupplyChain.vProductsBySuppliers, tampilan yang Anda buat sebelumnya dalam tutorial ini. Pilih.
Pilih tombol Muat .

Di panel Query1 , ganti teks yang Anda lihat di sana dengan string kueri GraphQL berikut:

query { vProductsbySuppliers(filter: { SupplierLocationID: { eq: 7 } }) { items { CompanyName SupplierLocationID ProductCount } } }

Pilih tombol Jalankan di jendela Query1 . Hasil kueri GraphQL dikembalikan ke jendela Hasil dalam format JSON.
Pilih tombol Salin titik akhir di pita.
Pilih tombol Salin saat panel Salin tautan muncul. Simpan string ini di notepad atau lokasi lain yang akan digunakan dalam aplikasi sampel untuk tutorial ini. Misalnya, ini akan terlihat mirip dengan: https://api.fabric.microsoft.com/v1/workspaces/<work space id>/graphqlapis/<graph api id>/graphql

API Anda untuk GraphQL sekarang siap untuk menerima koneksi dan permintaan. Anda dapat menggunakan editor API untuk menguji dan membuat prototipe kueri GraphQL dan penjelajah Skema untuk memverifikasi jenis data dan bidang yang diekspos di API. Untuk informasi selengkapnya, lihat Membuat GraphQL API dari database SQL Anda di portal Fabric.

Membuat aplikasi web untuk mengkueri data

Sejauh ini dalam tutorial ini Anda telah membuat database yang menyimpan penjualan dan produk untuk Contoso, dan menambahkan pemasok dan menggabungkan entitas menggunakan Transact-SQL (T-SQL). Anda sekarang ingin mengizinkan pengembang untuk menggunakan data tanpa harus mempelajari T-SQL, dan juga memungkinkan mereka untuk mengkueri beberapa komponen Microsoft Fabric dalam satu antarmuka. Jalankan aplikasi ini secara lokal di antarmuka .NET REST yang dihost sendiri yang mengakses titik akhir GraphQL yang Anda buat dalam tutorial ini. Anda juga dapat menyebarkan aplikasi ini langsung ke Microsoft Azure sebagai aplikasi web, atau ke server web lain pilihan Anda.

Membuat aplikasi web menggunakan database SQL di Fabric API untuk GraphQL

Anda telah diminta untuk membuat aplikasi yang menunjukkan semua Pemasok yang terpengaruh jika Lokasi memiliki pemutusan rantai pasokan, karena bencana alam atau gangguan lainnya. Kode ini menunjukkan cara membuat aplikasi ASP.NET yang menggunakan Kueri GraphQL untuk mengakses Kueri di titik akhir SQL In Fabric GraphQL yang Anda buat di bagian terakhir tutorial.

Cuplikan layar sampel aplikasi dari tutorial ini mengikuti: