एंटिटी फ्रेमवर्क कोर (डेटाबेस-पहले) का उपयोग करके SQL सर्वर तक पहुँचने के लिए तैयार करें

पेज अद्यतन :
पेज निर्माण की तारीख :

परिचालन का वातावरण

विजुअल स्टूडियो
  • विजुअल स्टूडियो 2022
।जाल
  • .नेट 8
एंटिटी फ्रेमवर्क कोर
  • एंटिटी फ्रेमवर्क कोर 8.0
SQL सर्वर
  • SQL सर्वर 2022

* उपरोक्त एक सत्यापन वातावरण है, लेकिन यह अन्य संस्करणों के साथ काम कर सकता है।

पहले

एंटिटी फ्रेमवर्क कोर ओ / आर मैपर्स की एक लाइब्रेरी है। डेटाबेस तक पहुँचने पर, आप सीधे SQL कथनों का उपयोग किए बिना, कोड में परिभाषित मॉडल (कक्षाओं) के माध्यम से डेटाबेस के रिकॉर्ड तक पहुँच सकते हैं। यह निम्नलिखित लाभ प्रदान करता है:

  • चूंकि एसक्यूएल स्टेटमेंट सीधे नहीं लिखे जाते हैं, इसलिए एसक्यूएल इंजेक्शन जैसे सुरक्षा जोखिम कम हो जाते हैं।
  • चूंकि एसक्यूएल स्टेटमेंट स्ट्रिंग्स हैं, भले ही आप सिंटैक्स में गलती करते हैं, यह बिल्ड त्रुटियों के लिए चेक नहीं किया जाता है, लेकिन चूंकि मॉडल एक प्रोग्राम सिंटैक्स है, इसलिए आप बिल्ड टाइम पर गलतियों की जांच कर सकते हैं।

एंटिटी फ्रेमवर्क कोर इन मॉडलों और डेटाबेस से कनेक्ट करने के लिए मौजूदा डेटाबेस से स्वचालित रूप से कोड उत्पन्न कर सकता है। इसके विपरीत, कोड को मैन्युअल रूप से लिखने और फिर स्वचालित रूप से डेटाबेस उत्पन्न करने का एक तरीका है।

पूर्व को "डेटाबेस-फर्स्ट" कहा जाता है और बाद वाले को "कोड-फर्स्ट" कहा जाता है। "मॉडल-फर्स्ट" भी है, जो ईआर आरेखों जैसे ब्लूप्रिंट से कोड और डेटाबेस उत्पन्न करता है, लेकिन यह एंटिटी फ्रेमवर्क कोर में व्यापक रूप से उपयोग नहीं किया जाता है।

इस मामले में, हम एक "डेटाबेस-फर्स्ट" पैटर्न का उपयोग करेंगे जो इस धारणा पर कोड उत्पन्न करता है कि डेटाबेस पहले से मौजूद है।

SQL सर्वर सेटअप

इस टिप में SQL सर्वर डेटाबेस तक पहुँचने के लिए, कृपया SQL सर्वर को पहले से सेट करें। इसे विकास के माहौल में पीसी पर या नेटवर्क के माध्यम से किसी अन्य पीसी पर स्थापित किया जा सकता है। यदि आप अपने विकास वातावरण से SQL सर्वर से कनेक्ट कर सकते हैं, तो आप जाने के लिए अच्छे हैं। इस युक्ति में, SQL सर्वर एक अलग वातावरण में स्थापित किया गया है।

SQL सर्वर सेटअप चरण छोड़े गए हैं क्योंकि वे अनावश्यक हैं। निम्न पृष्ठों में SQL सर्वर से संबंधित युक्तियाँ हैं, इसलिए यदि आप जानना चाहते हैं कि इसे कैसे सेट अप करें, तो कृपया इसे देखें.

कोई तालिका बनाना

इस बार, हम निम्नलिखित डेटाबेस और टेबल को Mr./Ms.. के रूप में बनाएंगे।

  • डेटाबेस नाम: TestDatabase
  • तालिका नाम: उपयोगकर्ता
  • तालिका स्तंभ: [ID], [नाम], [पासवर्ड], [आयु], [ईमेल], [जन्मदिन], [UpdateDateTime]

आप इसे किसी भी तरह से बना सकते हैं, लेकिन यदि आप इसे नहीं करना चाहते हैं, तो इसे उत्पन्न करने के लिए SQL सर्वर के विरुद्ध निम्न SQL चलाएँ।

निम्नलिखित डेटाबेस निर्माण एसक्यूएल है, लेकिन चूंकि डेटाबेस निर्माण का मार्ग संस्करण आदि के आधार पर बदलता है, इसलिए इसे एसक्यूएल के बजाय जीयूआई या कमांड के साथ बनाना अधिक विश्वसनीय हो सकता है।

USE [master]
GO
CREATE DATABASE [TestDatabase]
 CONTAINMENT = NONE
 ON  PRIMARY 
( NAME = N'TestDatabase', FILENAME = N'C:\Program Files\Microsoft SQL Server\MSSQL16.MSSQLSERVER\MSSQL\DATA\TestDatabase.mdf' , SIZE = 8192KB , MAXSIZE = UNLIMITED, FILEGROWTH = 65536KB )
 LOG ON 
( NAME = N'TestDatabase_log', FILENAME = N'C:\Program Files\Microsoft SQL Server\MSSQL16.MSSQLSERVER\MSSQL\DATA\TestDatabase_log.ldf' , SIZE = 8192KB , MAXSIZE = 2048GB , FILEGROWTH = 65536KB )
 WITH CATALOG_COLLATION = DATABASE_DEFAULT, LEDGER = OFF
GO
ALTER DATABASE [TestDatabase] SET COMPATIBILITY_LEVEL = 160
GO
IF (1 = FULLTEXTSERVICEPROPERTY('IsFullTextInstalled'))
begin
EXEC [TestDatabase].[dbo].[sp_fulltext_database] @action = 'enable'
end
GO
ALTER DATABASE [TestDatabase] SET ANSI_NULL_DEFAULT OFF 
GO
ALTER DATABASE [TestDatabase] SET ANSI_NULLS OFF 
GO
ALTER DATABASE [TestDatabase] SET ANSI_PADDING OFF 
GO
ALTER DATABASE [TestDatabase] SET ANSI_WARNINGS OFF 
GO
ALTER DATABASE [TestDatabase] SET ARITHABORT OFF 
GO
ALTER DATABASE [TestDatabase] SET AUTO_CLOSE OFF 
GO
ALTER DATABASE [TestDatabase] SET AUTO_SHRINK OFF 
GO
ALTER DATABASE [TestDatabase] SET AUTO_UPDATE_STATISTICS ON 
GO
ALTER DATABASE [TestDatabase] SET CURSOR_CLOSE_ON_COMMIT OFF 
GO
ALTER DATABASE [TestDatabase] SET CURSOR_DEFAULT  GLOBAL 
GO
ALTER DATABASE [TestDatabase] SET CONCAT_NULL_YIELDS_NULL OFF 
GO
ALTER DATABASE [TestDatabase] SET NUMERIC_ROUNDABORT OFF 
GO
ALTER DATABASE [TestDatabase] SET QUOTED_IDENTIFIER OFF 
GO
ALTER DATABASE [TestDatabase] SET RECURSIVE_TRIGGERS OFF 
GO
ALTER DATABASE [TestDatabase] SET  DISABLE_BROKER 
GO
ALTER DATABASE [TestDatabase] SET AUTO_UPDATE_STATISTICS_ASYNC OFF 
GO
ALTER DATABASE [TestDatabase] SET DATE_CORRELATION_OPTIMIZATION OFF 
GO
ALTER DATABASE [TestDatabase] SET TRUSTWORTHY OFF 
GO
ALTER DATABASE [TestDatabase] SET ALLOW_SNAPSHOT_ISOLATION OFF 
GO
ALTER DATABASE [TestDatabase] SET PARAMETERIZATION SIMPLE 
GO
ALTER DATABASE [TestDatabase] SET READ_COMMITTED_SNAPSHOT OFF 
GO
ALTER DATABASE [TestDatabase] SET HONOR_BROKER_PRIORITY OFF 
GO
ALTER DATABASE [TestDatabase] SET RECOVERY FULL 
GO
ALTER DATABASE [TestDatabase] SET  MULTI_USER 
GO
ALTER DATABASE [TestDatabase] SET PAGE_VERIFY CHECKSUM  
GO
ALTER DATABASE [TestDatabase] SET DB_CHAINING OFF 
GO
ALTER DATABASE [TestDatabase] SET FILESTREAM( NON_TRANSACTED_ACCESS = OFF ) 
GO
ALTER DATABASE [TestDatabase] SET TARGET_RECOVERY_TIME = 60 SECONDS 
GO
ALTER DATABASE [TestDatabase] SET DELAYED_DURABILITY = DISABLED 
GO
ALTER DATABASE [TestDatabase] SET ACCELERATED_DATABASE_RECOVERY = OFF  
GO
EXEC sys.sp_db_vardecimal_storage_format N'TestDatabase', N'ON'
GO
ALTER DATABASE [TestDatabase] SET QUERY_STORE = ON
GO
ALTER DATABASE [TestDatabase] SET QUERY_STORE (OPERATION_MODE = READ_WRITE, CLEANUP_POLICY = (STALE_QUERY_THRESHOLD_DAYS = 30), DATA_FLUSH_INTERVAL_SECONDS = 900, INTERVAL_LENGTH_MINUTES = 60, MAX_STORAGE_SIZE_MB = 1000, QUERY_CAPTURE_MODE = AUTO, SIZE_BASED_CLEANUP_MODE = AUTO, MAX_PLANS_PER_QUERY = 200, WAIT_STATS_CAPTURE_MODE = ON)
GO
ALTER DATABASE [TestDatabase] SET  READ_WRITE 
GO

तालिका निर्माण एसक्यूएल।

USE [TestDatabase]
GO

SET ANSI_NULLS ON
GO

SET QUOTED_IDENTIFIER ON
GO

CREATE TABLE [dbo].[User](
  [ID] [int] NOT NULL,
  [Name] [nvarchar](20) NOT NULL,
  [Password] [nvarchar](20) NOT NULL,
  [Age] [int] NULL,
  [Email] [nvarchar](200) NULL,
  [Birthday] [date] NULL,
  [UpdateDateTime] [datetime2](7) NULL,
  CONSTRAINT [PK_User] PRIMARY KEY CLUSTERED 
(
  [ID] ASC
)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON, OPTIMIZE_FOR_SEQUENTIAL_KEY = OFF) ON [PRIMARY]
) ON [PRIMARY]
GO

रिकॉर्ड एसक्यूएल संलग्न करें।

USE [TestDatabase]
GO
INSERT [dbo].[User] ([ID], [Name], [Password], [Age], [Email], [Birthday], [UpdateDateTime]) VALUES (1, N'氏名1', N'aaaa', 20, N'aaaa@example.com', CAST(N'2020-04-01' AS Date), CAST(N'2021-03-14T00:00:00.0000000' AS DateTime2))
GO
INSERT [dbo].[User] ([ID], [Name], [Password], [Age], [Email], [Birthday], [UpdateDateTime]) VALUES (2, N'氏名2', N'bbbb', 30, N'bbbb@example.com', CAST(N'2010-04-01' AS Date), CAST(N'2021-03-14T00:00:00.0000000' AS DateTime2))
GO

Visual Studio सेटअप

हम मानते हैं कि आपने इसे पहले ही सेट कर लिया है। यदि आप सेटअप प्रक्रिया आदि जानना चाहते हैं, तो इसे निम्न पृष्ठ पर संक्षेपित किया गया है।

एक प्रोजेक्ट बनाएं

एंटिटी फ्रेमवर्क कोर किसी विशेष निष्पादन वातावरण पर निर्भर नहीं है, इसलिए इसका उपयोग कई परियोजनाओं में किया जा सकता है। इस आलेख में, हम एक साधारण कंसोल अनुप्रयोग वातावरण में एंटिटी फ्रेमवर्क कोर का उपयोग करेंगे।

नए प्रोजेक्ट में, कंसोल ऐप चुनें।

परियोजना बनाई गई है। इससे कोई फर्क नहीं पड़ता कि परियोजना का नाम क्या है।

एंटिटी फ्रेमवर्क कोर पैकेज प्राप्त करें

NuGet के साथ Entity Framework Core का उपयोग करने के लिए एक पैकेज प्राप्त करें।

निर्भरता पर राइट-क्लिक करें और NuGet Packages प्रबंधित करें चुनें.

टैब से चयनित "ब्राउज़ करें" के साथ, खोज फ़ील्ड में प्रवेश करें EntityFrameworkCore । फिर आपको सूची में निकाय फ़्रेमवर्क कोर-संबंधित पैकेज देखना चाहिए.

चूंकि हम इस बार SQL सर्वर का उपयोग करेंगे, इसलिए हम निम्नलिखित पैकेज स्थापित करेंगे।

  • Microsoft.EntityFrameworkCore
  • Microsoft.EntityFrameworkCore.Tools
  • Microsoft.EntityFrameworkCore.SqlServer

Microsoft.EntityFrameworkCore इस उदाहरण में, हम स्थापित कर रहे हैं . अन्य दो को भी स्थापित करें।

स्थापना लक्ष्य का चयन करें और इंस्टॉल बटन पर क्लिक करें। संस्करण के लिए, नवीनतम स्थिर का चयन करें।

संवाद मूल रूप से ठीक है और आप ठीक क्लिक कर सकते हैं।

अन्य दो को भी स्थापित करें।

मुझे लगता है कि पैकेज इस तरह दिखता है:

डेटाबेस तालिका संरचना से एक मॉडल (कोड) बनाएं

मॉडल और अन्य कोड स्वचालित रूप से उत्पन्न होने के लिए, पहले यह सुनिश्चित करने के लिए प्रोजेक्ट बनाएं कि कोई त्रुटि नहीं है। यदि कोई त्रुटि है, तो मॉडल निर्माण विफल हो जाता है। यदि आप पहले ही सत्यापित कर चुके हैं कि कोई त्रुटि नहीं है, तो आपको इसे बनाने की आवश्यकता नहीं है।

Visual Studio से, पैकेज प्रबंधक कंसोल खोलें। यदि आपके पास एक नहीं है, तो आप इसे मेनू "टूल्स", "नुगेट पैकेज मैनेजर", "पैकेज मैनेजर कंसोल" से खोल सकते हैं।

निम्न विंडो प्रदर्शित की जाएगी, इसलिए सुनिश्चित करें कि ऊपरी दाएं कोने में "डिफ़ॉल्ट प्रोजेक्ट" वह प्रोजेक्ट है जिसके लिए आप एक मॉडल बनाना चाहते हैं। (यदि आपके पास कई परियोजनाएं हैं तो आपको सावधान रहने की आवश्यकता है)

इनपुट फ़ील्ड में निम्न पाठ दर्ज करें: पैरामीटर पर्यावरण के आधार पर बदलते हैं, इसलिए कृपया उन्हें निम्नलिखित स्पष्टीकरणों के अनुसार समय पर बदल दें।

Scaffold-DbContext -Provider Microsoft.EntityFrameworkCore.SqlServer -Connection "Data Source=<サーバー名>\<インスタンス名>;Database=<データメース名>;user id=<接続ユーザー名>;password=<接続パスワード>;TrustServerCertificate=true" -f -OutputDir "<出力フォルダパス>" -Context "<コンテキストクラス名>" -UseDatabaseNames -DataAnnotations -NoPluralize

उदाहरण इनपुट

Scaffold-DbContext -Provider Microsoft.EntityFrameworkCore.SqlServer -Connection "Data Source=TestServer;Database=TestDatabase;user id=TestUser;password=pass;TrustServerCertificate=true" -f -OutputDir "Models\Database" -Context "TestDatabaseDbContext" -UseDatabaseNames -DataAnnotations -NoPluralize
पैरामीटर विवरणपैरामीटर उदाहरण
प्रदाता SQL सर्वर के लिए, यह Microsoft.EntityFrameworkCore.SqlServer ठीक किया गया है। Microsoft.EntityFrameworkCore.SqlServer
नाता डेटाबेस से कनेक्ट करने के लिए कनेक्शन स्ट्रिंग। कनेक्शन स्ट्रिंग्स का उपयोग अन्य ऐप्स के साथ आम तौर पर किया जा सकता है, इसलिए कृपया निर्दिष्ट की जाने वाली सामग्री के लिए कनेक्शन स्ट्रिंग्स के नोटेशन का पालन करें। आप या तो Windows प्रमाणीकरण या SQL सर्वर प्रमाणीकरण का उपयोग कर सकते हैं। वैसे, इसका उपयोग केवल अस्थायी रूप से एक मॉडल बनाने के लिए किया जाता है, इसलिए इस कनेक्शन स्ट्रिंग के लिए एप्लिकेशन प्रकाशित करने के बाद सुरक्षा के बारे में जागरूक होने की कोई आवश्यकता नहीं है। यदि आपके पासवर्ड में प्रतीक हैं, तो बचने से सावधान रहें। "डेटा स्रोत सर्वर नाम \ SQLEXPRESS; डेटाबेस = टेस्टडेटाबेस; उपयोगकर्ता आईडी = उपयोगकर्ता नाम; पासवर्ड = **********"
स्‍त्री-विषयक यहां तक कि अगर प्रोग्राम पहले से मौजूद है, तो इसे जबरन ओवरराइट कर दिया जाएगा। कोई <> नहीं
आउटपुटडिर फ़ोल्डर पथ जहाँ आप कोड आउटपुट करना चाहते हैं। प्रोजेक्ट फ़ोल्डर के सापेक्ष पथ मॉडल\डेटाबेस
संदर्भ निकाय फ़्रेमवर्क का उपयोग करते समय संदर्भ वर्ग नाम TestDatabaseDbContext
डेटाबेस नाम का उपयोग करें यदि निर्दिष्ट किया गया है, तो डेटाबेस का तालिका नाम वर्ग का नाम होगा जैसा कि यह है। यदि निर्दिष्ट नहीं है, तो इकाई वर्ग नाम का मामला नियमों के अनुसार समायोजित किया जाता है। कोई <> नहीं
डेटाएनोटेशन निर्दिष्ट होने पर, स्तंभ प्रकार स्वचालित रूप से प्रत्येक गुण में DataAnnotation विशेषता जोड़ देता है. यदि आप डेटाबेस के प्रकार के अनुसार स्वचालित रूप से इनपुट जांच करना चाहते हैं तो यह थोड़ा उपयोगी है। कोई <> नहीं
Namespace वह नामस्थान जिससे जनरेट किया गया एंटिटी वर्ग संबंधित है. यदि निर्दिष्ट नहीं है, तो नामस्थान फ़ोल्डर के अनुसार निर्धारित किया जाता है। TestNamespace
ContextNamespace वह नामस्थान जिससे जनरेट किया गया प्रसंग संबंधित है. यदि निर्दिष्ट नहीं है, तो नामस्थान फ़ोल्डर के अनुसार निर्धारित किया जाता है। TestNamespace
NoOnConfiguring अपने कोड में कच्चे कनेक्शन स्ट्रिंग एम्बेड न करें। कोई <> नहीं
NoPluralize सुनिश्चित करें कि संदर्भ में प्रत्येक तालिका नाम के लिए गुण नाम बहुवचन नहीं हैं। कोई <> नहीं

जब आप इसे चलाने के लिए एंटर दबाते हैं, तो कोड स्वचालित रूप से उत्पन्न होता है: यदि कोई त्रुटि होती है, तो कारण प्रदर्शित किया जाएगा, इसलिए कृपया त्रुटि सामग्री के अनुसार प्रतिक्रिया दें।

User तालिका का मॉडल कोड इस प्रकार है।

using System.ComponentModel.DataAnnotations;

namespace SetupSqlServerDatabaseFirst.Models.Database;

public partial class User
{
  [Key]
  public int ID { get; set; }

  [StringLength(20)]
  public string Name { get; set; } = null!;

  [StringLength(20)]
  public string Password { get; set; } = null!;

  public int? Age { get; set; }

  [StringLength(200)]
  public string? Email { get; set; }

  public DateOnly? Birthday { get; set; }

  public DateTime? UpdateDateTime { get; set; }
}

वैसे, चेतावनी प्रदर्शित की जाती है क्योंकि कनेक्शन स्ट्रिंग लिखा जाता है क्योंकि यह उत्पन्न संदर्भ वर्ग के कोड में है। यदि संभव हो, तो कनेक्शन स्ट्रिंग को एक अलग स्थान पर संग्रहीत किया जाना चाहिए और रनटाइम पर सेट किया जाना चाहिए, लेकिन इस मामले में, यह ऑपरेशन की जांच करने के उद्देश्य से है, इसलिए मैं इसे वैसे ही छोड़ दूंगा।

रिकॉर्ड पुनर्प्राप्त करने और प्रदर्शित करने का प्रयास करें

अब जब हमारे पास डेटाबेस में रिकॉर्ड तक पहुंचने के लिए कोड है, तो आइए रिकॉर्ड को पुनः प्राप्त करने और उन्हें कंसोल पर प्रदर्शित करने का प्रयास करें।

Program.cs और इसे निम्नानुसार संशोधित करें।

// See https://aka.ms/new-console-template for more information
using SetupSqlServerDatabaseFirst.Models.Database;
using System.Text.Json;

Console.WriteLine("Hello, World!");

// データベースコンテキストのインスタンスを生成する
using var dbContext = new TestDatabaseDbContext();

// データベースから User 一覧を取得する
var users = dbContext.User.ToList();

// 取得した User 情報をコンソールに書き出す
foreach (var user in users)
{
  Console.WriteLine(JsonSerializer.Serialize(user));
}

में ऑटो-जेनरेट DbContext क्लास new जनरेट करें। इसे घोषित किया जाता है ताकि डेटाबेस कनेक्शन स्वचालित रूप से नष्ट हो सकें using var

dbContext प्रत्येक मॉडल तक पहुंचने के लिए गुण उत्पन्न करता है, इसलिए इस मामले User में, आप गुणों तक पहुंचकर User तालिका में रिकॉर्ड में हेरफेर कर सकते हैं। जारी किया गया SQL स्वचालित रूप से आंतरिक रूप से उत्पन्न होता है और इस पर ध्यान देने की आवश्यकता नहीं होती है।

ToList यहां, तालिका में सभी रिकॉर्ड को पुनः प्राप्त करने के लिए User एक एक्सटेंशन विधि का उपयोग किया जाता है।

foreach बाकी कंसोल पर जानकारी प्रदर्शित करने के लिए User AND JsonSerializer.Serialize विधियों का उपयोग करके किया जाता है। जैसा कि User ऊपर उल्लेख किया गया है, तालिका में प्रत्येक कॉलम को एक संपत्ति के रूप में घोषित किया गया है, इसलिए व्यक्तिगत रूप से मूल्य को पुनः प्राप्त करना संभव है।