DevOps ve GraphQL API'sini kullanarak uygulama oluşturma
Şunlar için geçerlidir:✅Microsoft Fabric'te SQL veritabanı
Öğreticinin bu bölümünde, oluşturduğunuz varlıkları kullanarak kullanıcının kesintiden etkilenen bir bölgeyi seçmesine olanak tanıyan bir web uygulaması oluşturacak ve ardından şirketi daha fazla tedarik zinciri kesintisi konusunda uyarmak için bu bölgedeki diğer tedarikçileri göreceksiniz. Verileriniz üzerinde bir GraphQL uç noktası oluşturacak ve ardından yerel olarak veya bulut sağlayıcısına dağıtabileceğiniz bir ASP.NET uygulaması oluşturacaksınız.
Yazılım geliştirme projeleri, biri kaynak denetimi olan Geliştirici İşlemleri (DevOps) görevlerini içerir. Oluşturduğunuz öğeleri kaynak denetimi altına yerleştirerek bu bölüme başlayacaksınız.
Bu makalede, Doku'daki SQL veritabanını temel alan bir uygulama oluşturmak için bir dizi yararlı senaryo sunulur.
Önkoşullar
- Bu öğreticide önceki tüm adımları tamamlayın.
- Git tümleştirme kiracısı ayarlarını etkinleştirin.
- GraphQL için API için Kiracı Yöneticisi Ayarını etkinleştirin.
- Microsoft Azure DevOps'ta Kuruluş ve Proje oluşturma.
Azure DevOps ile Dokuda CI/CD
Öğreticinin bu bölümünde, Azure DevOps ile Microsoft Fabric'teki SQL veritabanınızla çalışmayı öğreneceksiniz.
Microsoft Fabric'teki bir SQL veritabanı, SQL kullanıcılarının zaman içinde ve ekip genelinde veritabanı nesnelerinin tanımlarını izlemesine olanak sağlayan kaynak denetimi tümleştirmesine sahiptir:
Ekip, veritabanını kaynak denetimine işleyebilir ve bu da canlı veritabanını otomatik olarak yapılandırılan kaynak denetimi deposundaki (Azure DevOps) koda dönüştürür.
Ekip, veritabanı nesnelerini kaynak denetiminin içeriğinden güncelleştirebilir ve bu da veritabanına değişiklik değişikliği uygulamadan önce Azure DevOps'taki kodu doğrular.
Microsoft Fabric'teki kaynak kodu denetimi konusunda bilginiz yoksa önerilen kaynak aşağıdadır:
Kaynak denetimini kullanmaya başlama
Bu önkoşulları tamamladıktan sonra çalışma alanınızı Azure DevOps ile eşitlenmiş olarak tutabilirsiniz. Bu, çalışma alanında yaptığınız değişiklikleri Azure DevOps dalında işlemenize ve herhangi biri Azure DevOps dalında yeni işlemeler oluşturduğunda çalışma alanınızı güncelleştirmenize olanak tanır.
Şimdi hem depoyu hem de veritabanı nesnelerini güncelleştiren Azure DevOps kullanarak veritabanınızdaki nesnelerden birini düzenleyeceksiniz. Nesneleri doğrudan depoda düzenleyebilir veya oraya "gönderebilirsiniz", ancak bu durumda Azure DevOps ortamınızdaki tüm adımları gerçekleştirebilirsiniz.
Öğretici Çalışma Alanı görünümünüzde, Çalışma Alanınızın kaynak denetimi altında olacak şekilde ayarlandığından ve tüm nesnelerin Eşitlendi olarak görüntülendiğinden emin olun.
Çalışma Alanı görünümünde git simgesini, seçtiğiniz dalı ve Çalışma Alanının kaynak denetimiyle en son ne zaman eşitlendiğine ilişkin bir ileti görürsünüz. Tarih ve saatin yanında, Azure DevOps ortamınızda belirli bir konum için bir tanımlayıcı bağlantısı görürsünüz. Devam etmek için bu bağlantıyı açın.
İstenirse Azure DevOps ortamınızda oturum açın.
Azure DevOps ortamına girdikten sonra gezgin bölmesinde Dosyalar öğesini seçin. Doku ve depodaki SQL veritabanınızla eşitlenen nesneler görüntülenir.
suppy_chain_analytics_database genişletin. SQLDatabase, ardından dbo, ardından Tablolar ve sonra nesne Suppliers.sql.
Nesne içeriğindeki tablonun T-SQL tanımına dikkat edin. Üretim kodlama ortamında, bu nesne Visual Studio veya Visual Studio Code gibi geliştirme araçları kullanılarak değiştirilir. Her durumda, bu veritabanı nesnesinin tanımı, veritabanının geçerli durumundan yansıttığınız depoya çoğaltılır. Sonraki öğretici adımlarında veritabanı nesnelerinde bazı değişiklikler yapmak için Azure DevOps kaynak denetimini kullanalım.
[Fax]Sütun tanımı satırını bulun ve Düzenle düğmesini seçin. Sütun tanımını olarak[Fax] NVARCHAR (255) NULL,düzenleyin.İşleme düğmesini seçin.
Görüntülenen İşleme ileti kutusunu doldurun ve İşleme düğmesini seçin. Sizin ve ekibinizin yararına kaynak denetimindeki her değişikliği açıklayıcı olmaya çalışın.
İşleme, değişikliği depoya yazar.
Doku portalında SQL veritabanına geri dönün ve Kaynak Denetimi'ni seçin.
Bekleyen bir güncelleştirmeniz var. Üretimde bu değişiklikleri gözden geçireceksiniz. Tümünü Güncelleştir düğmesini seçin. Güncelleştirme biraz zaman alabilir.
Yapı adında SQL veritabanını seçin. SQL veritabanınızda yeni bir sorgu penceresi açın.
Tablodaki değişiklikleri veritabanında canlı olarak görmek için aşağıdaki T-SQL kodunu kopyalayıp yapıştırın:
SELECT * FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_NAME = 'Suppliers';Tabloya adlı
NotesSuppliersbir sütun eklemek için sorgulayan aşağıdaki T-SQL kodunu girin. Kodun yalnızca bu bölümünü vurgulayın ve Çalıştır düğmesini seçin:ALTER TABLE Suppliers ADD Notes NVARCHAR(MAX);Şimdi Doku portalında öğretici Çalışma Alanı'na dönün.
Kaynak Denetimi düğmesini seçin ve güncelleştirme yerine sisteminizin bir Değişiklik isteği gösterdiğine dikkat edin. Nesne adının yanındaki onay kutusunu seçin ve ardından İşle düğmesini seçin.
Sistem, sorgu düzenleyicisinde yapılan değişiklikleri işler ve Azure DevOps Portalı'na dönüp Dosyalar alanına, Şema'ya ve
dboardından Tablolar veSuppliersnesneye gidip yeni sütunu görebilirsiniz. (Değişikliği görmek için sayfayı yenilemeniz gerekebilir.)
Artık Azure DevOps'taki kaynak denetiminizden SQL veritabanı nesne şemalarınızla nasıl etkileşim kurabileceğinizi gördünüz. Microsoft Fabric'teki kaynak denetimi hakkında daha fazla bilgi için bkz . Microsoft Fabric'te SQL veritabanı kaynak denetimi tümleştirmesi ve Öğretici: Dokuda yaşam döngüsü yönetimi.
GraphQL API'sini ayarlama ve yapılandırma
Bir veritabanı uygulamasına bağlanmak genellikle uygulamanız için veritabanıyla doğrudan etkileşim kuran Tablosal Veri Akışı (TDS) protokolünün kullanıldığı bir kitaplık kümesi yüklemeyi içerir.
Microsoft Fabric yalnızca veritabanlarıyla değil, birden çok veri kaynağıyla çalışmaya yönelik bir GraphQL arabirimi içerir. Bu kaynakları tümleşik bir veri görünümü için de birleştirebilirsiniz. GraphQL, API'leri zaman içinde geliştirmeyi ve güçlü geliştirici araçlarını etkinleştirmeyi kolaylaştırarak tam olarak ihtiyacınız olan verileri istemenizi sağlayan API'ler için bir sorgu dilidir. API'nizdeki verilerin eksiksiz ve anlaşılır bir açıklamasını sunarak istemcilere tam olarak neye ihtiyaçları olduğunu sorma gücü verir ve başka bir şey istemez. Bu, GraphQL kullanan uygulamaların sunucuyu değil, aldıkları verileri denetledikleri için hızlı ve kararlı olmasını sağlar. GraphQL arabirimini bir veri kaynağı içinde yer alan bir veri kümesinin görünümünü sağlamak olarak düşünebilirsiniz. Mutasyonları kullanarak verileri sorgulayabilir ve değiştirebilirsiniz. Bu başvuruda GraphQL hakkında daha fazla bilgi edinebilirsiniz.
GraphQL API'lerini doğrudan Doku SQL sorgu düzenleyicisinden oluşturmaya başlayabilirsiniz. Doku, verilerinize göre GraphQL şemasını otomatik olarak oluşturur ve uygulamalar dakikalar içinde bağlanmaya hazırdır.
GraphQL için API oluşturma
Bir uygulama için kullanacağınız GraphQL API'sini oluşturmak için:
Öğretici veritabanı portalını açın.
Yeni düğmesini seçin ve GraphQL için API'yi seçin.
Öğenizin Adı için supplier_impact_gql metni girin ve Oluştur'u seçin.
Size Veri Seç paneli sunulur. Bu öğreticide daha önce oluşturduğunuz görünümünü bulana
SupplyChain.vProductsBySupplierskadar kaydırın. Bu öğeyi seçin.
Yükle düğmesini seçin.
Sorgu1 panelinde, orada gördüğünüz metni aşağıdaki GraphQL sorgu dizesiyle değiştirin:
query { vProductsbySuppliers(filter: { SupplierLocationID: { eq: 7 } }) { items { CompanyName SupplierLocationID ProductCount } } }Sorgu1 penceresinde Çalıştır düğmesini seçin. GraphQL sorgusunun sonuçları, Sonuçlar penceresine JSON biçiminde döndürülür.
Şeritte Uç noktayı kopyala düğmesini seçin.
Bağlantıyı kopyala paneli görüntülendiğinde Kopyala düğmesini seçin. Bu dizeyi, bu öğretici için örnek uygulamada kullanılacak bir not defterinde veya başka bir konumda depolayın. Örneğin, şuna benzer olacaktır:
https://api.fabric.microsoft.com/v1/workspaces/<work space id>/graphqlapis/<graph api id>/graphql
GraphQL API'niz artık bağlantıları ve istekleri kabul etmeye hazırdır. GraphQL sorgularını test etmek ve prototipini yapmak için API düzenleyicisini ve API'de kullanıma sunulan veri türlerini ve alanları doğrulamak için Şema gezginini kullanabilirsiniz. Daha fazla bilgi için bkz . Doku portalında SQL veritabanınızdan GraphQL API'sini oluşturma.
Verileri sorgulamak için web uygulaması oluşturma
Bu öğreticide şimdiye kadar Contoso'nun satışlarını ve ürünlerini depolayan bir veritabanı oluşturdunuz ve Transact-SQL (T-SQL) kullanarak sağlayıcılar ve varlıklara katıldınız. Şimdi geliştiricilerin T-SQL öğrenmek zorunda kalmadan verileri kullanmasına izin vermek ve aynı zamanda tek bir arabirimde birden çok Microsoft Fabric bileşenini sorgulamalarını sağlamak istiyorsunuz. Bu uygulamayı, bu öğreticide oluşturduğunuz GraphQL uç noktasına erişen şirket içinde barındırılan bir .NET REST arabiriminde yerel olarak çalıştırın. Ayrıca bu uygulamayı doğrudan Microsoft Azure'a bir web uygulaması olarak veya seçtiğiniz başka bir web sunucusuna dağıtabilirsiniz.
GraphQL için Doku API'sinde SQL veritabanını kullanarak web uygulaması oluşturma
Doğal afetler veya diğer kesintiler nedeniyle bir Konumda tedarik zincirinin kesilmesi durumunda etkilenen tüm Tedarikçileri gösteren bir uygulama oluşturmanız istendi. Bu kod, öğreticinin son bölümünde oluşturduğunuz Sql In Fabric GraphQL uç noktasındaki bir Sorguya erişmek için GraphQL Sorgusu kullanan bir ASP.NET uygulamasının nasıl oluşturulacağını gösterir.
- İşletim sisteminiz için uygun .NET SDK'sını yükleyin.
- Kaynağı bu konumda açın ve orada gördüğünüz tüm adımları izleyin.
Bu öğreticideki uygulamanın örnek ekran görüntüleri aşağıdaki gibidir:
