SQL Connect স্কিমা ডিজাইন করা

Firebase SQL Connect-এর মাধ্যমে, আপনি একটি GraphQL স্কিমা ডিজাইন করেন যা আপনার অ্যাপ্লিকেশনের জন্য প্রয়োজনীয় ডেটা মডেলকে উপস্থাপন করে। SQL Connect এই স্কিমাকে PostgreSQL ইনস্ট্যান্সের জন্য Cloud SQL-এ কনভার্ট করে যা আপনার অ্যাপকে ব্যাক-আপ করে। আপনি তারপর ব্যাকএন্ডের সাথে ইন্টারফেস করার জন্য কোয়েরি এবং মিউটেশন তৈরি করেন এবং ক্লায়েন্ট কোড থেকে আপনার ডেটা ব্যবহার করার জন্য এই অপারেশনগুলিকে কানেক্টরে বান্ডিল করেন।

আপনার স্কিমা ডিজাইন ও প্রয়োগ করতে সাহায্য করার জন্য SQL Connect AI টুলিং অফার করে। এই নির্দেশিকা স্কিমা ডিজাইনের গুরুত্বপূর্ণ ধারণাগুলি উপস্থাপন করে যা আপনার স্ট্যান্ডার্ড এবং AI-সহায়তা প্রাপ্ত ওয়ার্কফ্লোকে সমর্থন এবং পরিপূরক করে যখন আপনি একটি অ্যাপ ডেভেলপ করা শুরু করেন, এবং তার বাইরে।

শুরু করার নির্দেশিকা-তে PostgreSQL-এর জন্য মুভি রিভিউ অ্যাপ স্কিমা পরিচয় করিয়ে দেওয়া হয়েছে।

এই নির্দেশিকা সেই স্কিমাকে আরও উন্নত করে এবং চূড়ান্ত মুভি রিভিউ অ্যাপ স্কিমার সমতুল্য একটি SQL তালিকা প্রদান করে।

মুভি রিভিউ অ্যাপের স্কিমা

ধরুন, আপনি এমন একটি পরিষেবা তৈরি করতে চান যা ব্যবহারকারীদের সিনেমার রিভিউ জমা দিতে এবং দেখতে দেয়।

প্রাথমিক কোয়েরি সাপোর্ট করার জন্য এই ধরনের অ্যাপের ক্ষেত্রে আপনার প্রাথমিক স্কিমা প্রয়োজন। আপনি জটিল রিলেশনাল কোয়েরি তৈরি করতে পরে এই স্কিমা এক্সটেন্ড করবেন।

SQL Connect-এ, আপনি GraphQL প্রকার সংজ্ঞায়িত করবেন যাতে আপনার ক্লায়েন্টরা কোয়েরি এবং ম্যানিপুলেট করতে পারে এমন ডেটার আকার সংজ্ঞায়িত করতে পারে। আপনি যখন স্কিমা লেখেন, তখন আপনার টাইপ PostgreSQL টেবিলের জন্য Cloud SQL-এ অনুবাদ করা হয়, বেশিরভাগ ক্ষেত্রে GraphQL টাইপ এবং ডেটাবেস টেবিলের মধ্যে সরাসরি সম্পর্ক থাকে, যদিও অন্যান্য ম্যাপিং সম্ভব। এই নির্দেশিকায় প্রাথমিক থেকে আরও উন্নত কিছু উদাহরণ দেখানো হয়েছে।

একটি মৌলিক Movie প্রকারের সংজ্ঞা দাও

আপনি Movie ধরনের বিজ্ঞাপন দিয়ে শুরু করতে পারেন।

Movie-এর স্কিমায় এই ধরনের মূল নির্দেশিকা থাকে:

  • SQL টেবিল ও কলামের নাম কাস্টমাইজ করতে @table(name) ও @col(name)। SQL Connect উল্লেখ করা না থাকলে snake_case নাম জেনারেট করে।
  • SQL কলামের ধরন কাস্টমাইজ করতে @col(dataType)।
  • ইনসার্ট করার সময় SQL কলামের ডিফল্ট ভ্যালু কনফিগার করতে @default।

আরও বিবরণের জন্য, @table, @col, @default-এর জন্য রেফারেন্স ডকুমেন্ট চেক করুন।

# Movies
type Movie @table(name: "movie", key: "id") {
  id: UUID! @col(name: "movie_id") @default(expr: "uuidV4()")
  title: String!
  releaseYear: Int
  genre: String @col(dataType: "varchar(20)")
  rating: Int
  description: String
}

User টাইপে ব্যবহারকারীর গুরুত্বপূর্ণ ডেটা অটোমেটিক স্টোর করুন

আপনার অ্যাপ ব্যবহারকারীদের ট্র্যাক করবে, তাই আপনার User ধরনের প্রয়োজন।

এই ক্ষেত্রে @default নির্দেশিকা বিশেষভাবে উপযোগী। এখানে id ফিল্ড অটোমেটিক যাচাইকরণ থেকে ব্যবহারকারীর আইডি নিতে পারে: নিম্নলিখিত স্যাম্পেলে @default(expr: "auth.uid")-এর ব্যবহার লক্ষ্য করুন।

# Users
# Suppose a user can leave reviews for movies
type User @table {
  id: String! @default(expr: "auth.uid")
  username: String! @col(dataType: "varchar(50)")
}

মূল স্কেলার ও সার্ভার ভ্যালু

মুভি রিভিউ অ্যাপটি আরও দেখার আগে, SQL Connect কী স্কেলার এবং সার্ভার ভ্যালু সম্পর্কে জানা গুরুত্বপূর্ণ।

কী স্কেলার হল সংক্ষিপ্ত অবজেক্ট আইডেন্টিফায়ার যা SQL Connect আপনার স্কিমার কী ফিল্ড থেকে অটোমেটিক অ্যাসেম্বল করে। মূল স্কেলারগুলি দক্ষতার সাথে সম্পর্কিত, যা আপনাকে একটি কল থেকেই আপনার ডেটার পরিচয় এবং গঠন সম্পর্কে তথ্য খুঁজে পেতে দেয়। নতুন রেকর্ডে সিকোয়েন্সিয়াল অ্যাকশন পারফর্ম করতে চাইলে এবং আসন্ন অপারেশনে পাস করার জন্য অনন্য শনাক্তযোগ্য প্রয়োজন হলে, এগুলি বিশেষভাবে উপযোগী। এছাড়াও, অতিরিক্ত আরও জটিল অপারেশন পারফর্ম করার জন্য রিলেশনাল কী অ্যাক্সেস করতে চাইলে, এগুলি বিশেষভাবে উপযোগী।

সার্ভার ভ্যালু ব্যবহার করে, আপনি কার্যকরভাবে সার্ভারকে আপনার টেবিলের ফিল্ডগুলি ডায়নামিকভাবে পূরণ করতে দিতে পারেন। এটি expr আর্গুমেন্টে নির্দিষ্ট সার্ভার-সাইড CEL এক্সপ্রেশন অনুযায়ী স্টোর করা বা সহজেই গণনাযোগ্য ভ্যালু ব্যবহার করে করা হয়। যেমন, আপনি অপারেশন অনুরোধে স্টোর করা সময়, updatedAt: Timestamp! @default(expr: "request.time") ব্যবহার করে ফিল্ড অ্যাক্সেস করার সময়, টাইমস্ট্যাম্প সহ একটি ফিল্ড নির্ধারণ করতে পারেন।

Actor ও MovieActor ধরনের অনেকের-সাথে-অনেক সম্পর্ক ম্যানেজ করুন

ব্যবহারকারীদের হ্যান্ডেল করার পরে, আপনি সিনেমার ডেটা মডেলিংয়ে ফিরে যেতে পারেন।

এরপর, আপনি চান যে অভিনেতারা আপনার সিনেমায় অভিনয় করুক।

Actor টেবিলটি বেশ সহজ।

# Actors
# Suppose an actor can participate in multiple movies and movies can have multiple actors
# Movie - Actors (or vice versa) is a many to many relationship
type Actor @table {
  id: UUID! @default(expr: "uuidV4()")
  name: String! @col(dataType: "varchar(30)")
}

আপনি যদি চান যে অভিনেতারা একাধিক সিনেমাতে অভিনয় করুন এবং সিনেমাতে একাধিক অভিনেতা থাকুক, তাহলে আপনাকে "টেবিল যোগ করতে" হবে।

MovieActor টেবিল অনেকের-সাথে-অনেক সম্পর্ক ম্যানেজ করে এবং এর প্রাথমিক কী হল [movie, actor]-এর একটি কম্বিনেশন (movie এবং actor থেকে ফরেন কী ফিল্ড)।

# Join table for many-to-many relationship for movies and actors
# The 'key' param signifies the primary keys of this table
# In this case, the keys are [movieId, actorId], the foreign key fields of the reference fields [movie, actor]
type MovieActor @table(key: ["movie", "actor"]) {
  movie: Movie!
  # movieId: UUID! <- implicitly added foreign key field
  actor: Actor!
  # actorId: UUID! <- implicitly added foreign key field
  role: String! # "main" or "supporting"
  # optional other fields
}

আপনি যখন ফরেন কী কনস্ট্রেন্ট সহ টেবিলে SQL রিলেশনশিপ নির্ধারণ করেন, তখন SQL Connect অটোমেটিক অন্য দিকে সংশ্লিষ্ট ফিল্ড জেনারেট করে। আপনাকে রিভার্স ম্যাপিং ফিল্ড (যেমন, Actor থেকে আবার MovieActor-এ) সংজ্ঞায়িত করতে হবে না।

MovieMetadata টাইপে ওয়ান-টু-ওয়ান সম্পর্ক ম্যানেজ করুন

এখন, সিনেমার পরিচালকদের ট্র্যাক করার পাশাপাশি Movie-এর সাথে এক-থেকে-এক সম্পর্ক সেট-আপ করুন।

আপনি ফরেন কী কনস্ট্রেন্ট কাস্টমাইজ করতে @ref নির্দেশিকা ব্যবহার করতে পারেন:

  • @ref(fields) কোন ফরেন কী ফিল্ড ব্যবহার করতে হবে তা নির্দিষ্ট করে।
  • @ref(references) টার্গেট টেবিলে রেফারেন্স করা ফিল্ড নির্দিষ্ট করে (ডিফল্ট হিসেবে প্রাথমিক কী, তবে @unique ফিল্ডও কাজ করে)। এটি আরও উন্নত বিকল্প; SQL Connect প্রায়ই আপনার জন্য এটি অনুমান করতে পারে।

আরও জানতে, @ref-এর জন্য রেফারেন্স ডকুমেন্ট চেক করুন।

# Movie Metadata
# Movie - MovieMetadata is a one-to-one relationship
type MovieMetadata @table {
  # @unique ensures that each Movie only has one MovieMetadata.
  movie: Movie! @unique
  # Since it references to another table type, it adds a foreign key constraint.
  #  movie: Movie! @unique @ref(fields: "movieId", references: "id")
  #  movieId: UUID! <- implicitly added foreign key field
  director: String
}

অপারেশন তৈরি করতে আপনার স্কিমা থেকে জেনারেট করা ফিল্ড ব্যবহার করুন

আপনার SQL Connect অপারেশন, আপনার স্কিমার ধরন ও ধরনের সম্পর্কের উপর ভিত্তি করে SQL Connect-এর মাধ্যমে অটোমেটিক জেনারেট করা ফিল্ডের সেটকে এক্সটেন্ড করবে। আপনি যখনই আপনার স্কিমা এডিট করেন, তখনই লোকাল টুলিংয়ের মাধ্যমে এইসব ফিল্ড জেনারেট করা হয়।

ধরে নিন, আপনার স্কিমায় Movie ধরন এবং এর সাথে সম্পর্কিত Actor ধরন রয়েছে। SQL Connect, movie, movies, actors_on_movies ফিল্ড এবং আরও অনেক কিছু তৈরি করে।


movie ফিল্ড সহ কোয়েরি

movie ফিল্ডটি Movie টেবিলের একটি রেকর্ডকে প্রতিনিধিত্ব করে।

কোনও একটি সিনেমাকে তার কী দিয়ে কোয়েরি করতে এই ফিল্ড ব্যবহার করুন।

query GetMovie($myKey: Movie_Key!) {
  movie(key: $myKey) { title }
}


movies ফিল্ড সহ কোয়েরি

movies ফিল্ডটি Movie টেবিলের রেকর্ডের একটি তালিকা দেখায়।

একাধিক সিনেমা কোয়েরি করতে এই ফিল্ড ব্যবহার করুন, যেমন, কোনও নির্দিষ্ট বছরে রিলিজ হওয়া সব সিনেমা।

query GetMovies($myYear: Int!) {
  movies(where: { year: { eq: $myYear } }) { title }
}


actors_on_movies ফিল্ড সহ কোয়েরি

actors_on_movies ফিল্ডটি Actor এবং Movie টেবিলকে কানেক্ট করে এমন রেকর্ডের তালিকা দেখায়। কোনও নির্দিষ্ট সিনেমার সাথে যুক্ত সব অভিনেতার ব্যাপারে কোয়েরি করতে এই ফিল্ড ব্যবহার করুন।

কোনও নির্দিষ্ট সিনেমার সাথে যুক্ত সব অভিনেতার ব্যাপারে কোয়েরি করতে এই ফিল্ড ব্যবহার করুন।

  query GetActorsOnMovie($myKey: Movie_Key!) {
    actors_on_movies(where: { movie: { key: { eq: $myKey } } }) {
      actor { name }
    }
  }

এটি মাথায় রেখে, আপনি কোয়েরি প্রয়োগ করার নির্দেশিকা এবং মিউটেশন প্রয়োগ করার নির্দেশিকা থেকে এইসব ফিল্ড ব্যবহার করে কীভাবে অপারেশন প্রয়োগ করতে হয় তা পড়তে পারবেন।

আরও উন্নত স্কিমা ধারণা

এনিউমারেশন ফিল্ড

SQL Connect-এ এনিউমারেশন ফিল্ডের সুবিধা আছে যা PostgreSQL এনিউমেরেটেড টাইপের সাথে ম্যাপ করে। Enum আপনাকে নির্দিষ্ট ক্রম সহ স্ট্যাটিক, আগে থেকে নির্ধারিত মানের তালিকা দ্রুত সংজ্ঞায়িত করতে দেয়।

আপনার স্কিমায় enum যোগ করতে, enum ও সেটির আগে থেকে নির্ধারিত ভ্যালু ঘোষণা করুন, তারপর আপনার টাইপে এটি রেফারেন্স করুন।

enum AspectRatio {
   ACADEMY
   WIDESCREEN
   ANAMORPHIC
   IMAX
   "No information available on aspect ratio"
   UNAVAILABLE
}

type Movie
  @table {
  title: String! 
  genre: String
  description: String
  originalAspectRatio: AspectRatio! @default(value: WIDESCREEN)
  otherAspectRatios: [AspectRatio!]
  tags: [String]
  rating: Float
  imageUrl: String!
  releaseYear: Int
}

Movie টাইপে, আমরা originalAspectRatio enum ফিল্ড যোগ করেছি, যাতে সিনেমাটি যে অ্যাস্পেক্ট রেশিওতে শ্যুট করা হয়েছে তা উল্লেখ করা যায় এবং অন্য একটি ফিল্ড otherAspectRatios যোগ করেছি, যাতে অন্যান্য উপলভ্য অ্যাস্পেক্ট রেশিওর তালিকা উল্লেখ করা যায়।

এনিউমারেশন ফিল্ডে পরিবর্তন ম্যানেজ করা

আপনি enum-এ নতুন ভ্যালু যোগ করতে পারেন, তবে enum তালিকার ক্রম খুবই গুরুত্বপূর্ণ, তাই আপনার নতুন ভ্যালুগুলি বুদ্ধিমানের মতো যোগ করুন। enum-এ একমাত্র সম্পূর্ণ ব্যাকওয়ার্ড কম্প্যাটিবল পরিবর্তন হল ভ্যালুর তালিকার শেষে নতুন ভ্যালু যোগ করা। উল্লেখযোগ্যভাবে, আগে থেকে প্রকাশিত enum-এর মধ্যে নতুন ভ্যালু যোগ করা বা আগে থেকে থাকা ভ্যালু আবার সাজালে, কোয়েরিতে "এর থেকে কম" মতো রিলেটিভ অপারেটর ব্যবহার করা হলে, রিলেটিভ অর্ডারিং পরিবর্তন হয়। ভ্যালু সরানো বা নাম পরিবর্তন করা সবসময় ব্যাকওয়ার্ড ইনকমপ্যাটিবিলিটি পরিবর্তন।

enum ভ্যালুর তালিকায় ভ্যালুগুলি কখনই নতুন করে সাজাবেন না; ক্রমটি গুরুত্বপূর্ণ কারণ এটি ফিল্টারিং কীভাবে প্রয়োগ করা হয় তা পরিবর্তন করে।

enum ভ্যালু অ্যাডজাস্ট করার সময় সতর্ক থাকতে হবে যাতে আপনার অপারেশন বা ক্লায়েন্ট কোডের পুরনো ভার্সন ভেঙে না যায়। কোনও enum ভ্যালু সরানোর বা নাম পরিবর্তন করার সময়, আপনার বর্তমান ডেটাবেসে কোনও ইনস্ট্যান্স বাকি নেই তা নিশ্চিত করুন।

অপারেশন ও ক্লায়েন্ট কোডে আপনার enum ফিল্ড ব্যবহার করা

এখন আপনি স্কিমাতে enum ফিল্ড যোগ করেছেন, আপনি এই ফিল্ড কোয়েরি ও ক্লায়েন্ট কোডে ব্যবহার করতে পারবেন।

কোয়েরি সংক্রান্ত নির্দেশিকা থেকে শুরু করে enum ব্যবহার করে কোয়েরি লেখা এবং আপনার enum-এ অ্যাডজাস্টমেন্টের অনুমতি দেওয়ার জন্য কীভাবে ক্লায়েন্ট লিখতে হয় সেই সম্পর্কে আরও জানুন।

অন্যান্য উন্নত ধারণা

বেসিক কিন্তু উপযোগী ধরন ও সম্পর্ক ছাড়াও আরও অনেক কিছু জানতে, রেফারেন্স ডকুমেন্টেশন-এ দেওয়া উদাহরণ দেখুন।

যেসব ডেটার ধরন কাজ করে

SQL Connect নিম্নলিখিত স্কেলার ডেটার ধরন সাপোর্ট করে, @col(dataType:) ব্যবহার করে PostgreSQL-এর ধরন অ্যাসাইন করা হয়।

SQL Connect ধরন GraphQL বিল্ট-ইন টাইপ অথবা
SQL Connect কাস্টম টাইপ 		ডিফল্ট PostgreSQL-এর ধরন PostgreSQL-এর যেসব ধরন কাজ করে
(বন্ধনীতে উপনাম)
স্ট্রিং GraphQL পাঠ্য text
bit(n), varbit(n)
char(n), varchar(n)
Int GraphQL int Int2 (smallint, smallserial),
int4 (integer, int, serial)
ফ্লোট GraphQL float8 float4 (real)
float8 (double precision)
numeric (decimal)
Boolean GraphQL বুলিয়ান বুলিয়ান
UUID কাস্টম uuid uuid
Int64 কাস্টম bigint int8 (bigint, bigserial)
numeric (decimal)
তারিখ কাস্টম তারিখ তারিখ
টাইমস্ট্যাম্প কাস্টম timestamptz

timestamptz

মনে রাখবেন: স্থানীয় টাইমজোন সংক্রান্ত তথ্য স্টোর করা হয় না।
PostgreSQL এই ধরনের টাইমস্ট্যাম্পকে UTC হিসেবে কনভার্ট ও স্টোর করে।
গণনা কাস্টম enum

enum
ভেক্টর কাস্টম ভেক্টর

ভেক্টর

Vertex AI-এর সাহায্যে ভেক্টর সিমিলারিটি সার্চ করা দেখুন।
  • GraphQL List একটি এক-মাত্রিক অ্যারেতে ম্যাপ করে।
    • যেমন, [Int] ম্যাপ করছে int5[]-এ, [Any] ম্যাপ করছে jsonb[]-এ।
    • SQL Connect-এ নেস্টেড অ্যারে কাজ করে না।

সমতুল্য SQL স্কিমা

-- Movies Table
CREATE TABLE Movies (
    movie_id UUID DEFAULT uuid_generate_v4() PRIMARY KEY,
    title VARCHAR(255) NOT NULL,
    release_year INT,
    genre VARCHAR(30),
    rating INT,
    description TEXT,
    tags TEXT[]
);
-- Movie Metadata Table
CREATE TABLE MovieMetadata (
    movie_id UUID REFERENCES Movies(movie_id) UNIQUE,
    director VARCHAR(255) NOT NULL,
    PRIMARY KEY (movie_id)
);
-- Actors Table
CREATE TABLE Actors (
    actor_id UUID DEFAULT uuid_generate_v4() PRIMARY KEY,
    name VARCHAR(30) NOT NULL
);
-- MovieActor Join Table for Many-to-Many Relationship
CREATE TABLE MovieActor (
    movie_id UUID REFERENCES Movies(movie_id),
    actor_id UUID REFERENCES Actors(actor_id),
    role VARCHAR(50) NOT NULL, # "main" or "supporting"
    PRIMARY KEY (movie_id, actor_id),
    FOREIGN KEY (movie_id) REFERENCES Movies(movie_id),
    FOREIGN KEY (actor_id) REFERENCES Actors(actor_id)
);
-- Users Table
CREATE TABLE Users (
    user_id UUID DEFAULT uuid_generate_v4() PRIMARY KEY,
    user_auth VARCHAR(255) NOT NULL
    username VARCHAR(30) NOT NULL
);
-- Reviews Table
CREATE TABLE Reviews (
    review_id UUID DEFAULT uuid_generate_v4() PRIMARY KEY,
    user_id UUID REFERENCES Users(user_id),
    movie_id UUID REFERENCES Movies(movie_id),
    rating INT,
    review_text TEXT,
    review_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    UNIQUE (movie_id, user_id)
    FOREIGN KEY (user_id) REFERENCES Users(user_id),
    FOREIGN KEY (movie_id) REFERENCES Movies(movie_id)
);
-- Self Join Example for Movie Sequel Relationship
ALTER TABLE Movies
ADD COLUMN sequel_to UUID REFERENCES Movies(movie_id);

পরবর্তী ধাপ

আপনি হয়ত আগ্রহী হবেন: