স্থানীয়ভাবে Firebase ডেটা সংযোগ দিয়ে শুরু করুন, স্থানীয়ভাবে Firebase ডেটা সংযোগ দিয়ে শুরু করুন৷

পরামর্শ: Firebase এর প্রথম SQL সমাধান সম্পর্কে আরও জানতে Firebase Data Connect Private Preview প্রোগ্রামে যোগ দিন। আপনি এই পণ্যটির প্রাথমিক গ্রহণকারী হওয়ার সুযোগ পাবেন এবং আপনার অ্যাপ ডেভেলপমেন্ট অভিজ্ঞতাকে আধুনিক করার জন্য Firebase-এর একেবারে নতুন প্রচেষ্টা সম্পর্কে প্রথম হাতের তথ্য পাবেন। Firebase Data Connect পণ্য পৃষ্ঠায় সাইন আপ করুন।

প্রিভিউ: Firebase Data Connect প্রাইভেট প্রিভিউতে রয়েছে, যার মানে হল যে প্রোডাক্টটি কোনও SLA বা অবচয় নীতির অধীন নয় এবং পিছনের-অসঙ্গত উপায়ে পরিবর্তন হতে পারে। ব্যক্তিগত পূর্বরূপ জুড়ে, Data Connect এবং এর ডকুমেন্টেশন আপডেট এবং উন্নত করা হবে। প্রোডাকশন অ্যাপে প্রোডাক্টের প্রাইভেট প্রিভিউ রিলিজ ব্যবহার করা উচিত নয়।

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

• আপনার Firebase প্রকল্পে Firebase Data Connect যোগ করুন।
• একটি স্থানীয় উদাহরণের সাথে কাজ করার জন্য একটি ভিজ্যুয়াল স্টুডিও কোড এক্সটেনশন সহ একটি উন্নয়ন পরিবেশ সেট আপ করুন৷
• তারপর আমরা আপনাকে দেখাব কিভাবে:
  • একটি মুভি অ্যাপের জন্য একটি স্কিমা তৈরি করুন
  • আপনার অ্যাপে ব্যবহার করা হবে এমন প্রশ্ন এবং মিউটেশন সংজ্ঞায়িত করুন
  • স্থানীয় এমুলেটরের বিরুদ্ধে নমুনা ডেটা সহ আপনার প্রশ্ন এবং মিউটেশন পরীক্ষা করুন
  • দৃঢ়ভাবে টাইপ করা SDK তৈরি করুন এবং আপনার অ্যাপে ব্যবহার করুন
  • আপনার চূড়ান্ত স্কিমা, প্রশ্ন এবং ডেটা ক্লাউডে স্থাপন করুন (ঐচ্ছিক, ব্লেজ পরিকল্পনা প্রয়োজন)।

পূর্বশর্ত

এই কুইকস্টার্ট ব্যবহার করার জন্য, আপনার নিম্নলিখিতগুলির প্রয়োজন হবে৷

• লিনাক্স, ম্যাকওএস বা উইন্ডোজ
• ভিজ্যুয়াল স্টুডিও কোড
• Windows এর জন্য nvm-windows বা macOS বা Linux এর জন্য nvm ব্যবহার করে Node.js ইনস্টল করুন।
• আপনি যদি ইতিমধ্যেই না করে থাকেন তাহলে Firebase কনসোলে একটি Firebase প্রকল্প তৈরি করুন।

উন্নয়ন পরিবেশ সেট আপ করুন

স্কিমা পরিচালনা করতে আপনার ভিজ্যুয়াল স্টুডিও কোডের প্রয়োজন হবে এবং আপনার অ্যাপ্লিকেশানে ব্যবহৃত প্রশ্নগুলিকে সংজ্ঞায়িত করতে হবে এবং আপনার জন্য একটি দৃঢ়ভাবে টাইপ করা SDK স্বয়ংক্রিয়ভাবে তৈরি হবে:

1. আপনার স্থানীয় প্রকল্পের জন্য একটি নতুন ডিরেক্টরি তৈরি করুন।
2. নতুন ডিরেক্টরিতে VS কোড খুলুন।
3. ভিজ্যুয়াল স্টুডিও কোড মার্কেটপ্লেস থেকে ফায়ারবেস ডেটা কানেক্ট এক্সটেনশন ইনস্টল করুন

আপনার প্রকল্প ডিরেক্টরি সেট আপ করুন

আপনার স্থানীয় প্রকল্প সেট আপ করতে, আপনার প্রকল্প ডিরেক্টরি শুরু করুন. VS Code বামদিকের প্যানেলে, Data Connect VS Code এক্সটেনশন UI খুলতে Firebase আইকনে ক্লিক করুন:

1. সাইন ইন উইথ গুগল বোতামে ক্লিক করুন।
2. কানেক্ট একটি ফায়ারবেস প্রজেক্ট বোতামে ক্লিক করুন এবং কনসোলে আপনার আগে তৈরি করা প্রজেক্টটি নির্বাচন করুন।
3. রান ফায়ারবেস ইনিট বোতামে ক্লিক করুন।

4. যদি আপনার প্রজেক্টটি ব্লেজ প্ল্যানে থাকে, যখন অনুরোধ করা হয় "আপনি কি এখন আপনার ব্যাকএন্ড সংস্থানগুলি কনফিগার করতে চান?", উত্তর দিন "না" ৷

   দ্রষ্টব্য: যদি আপনার প্রকল্পটি স্পার্ক প্ল্যানে থাকে বা আপনার যদি ইতিমধ্যেই একটি ক্লাউড এসকিউএল ইন্সট্যান্স সেটআপ থাকে তবে আপনাকে এই প্রশ্নটি জিজ্ঞাসা করা হবে না।

5. যখন অনুরোধ করা হয় "আপনি কি এখন জেনারেট করা SDK গুলি কনফিগার করতে চান?", উত্তর দিন "না"

   দ্রষ্টব্য: টুলিং স্বয়ংক্রিয়ভাবে আপনার জন্য SDK কনফিগার করে যদি এটি ক্লায়েন্ট সোর্স কোড ধারণকারী ডিরেক্টরি সনাক্ত করে। আপনার প্রোজেক্ট ডিরেক্টরীতে কোন ক্লায়েন্ট কোড না থাকলে, "না" উত্তর দিন। আমরা আপনাকে দেখাব কীভাবে আপনার SDK গুলি কনফিগার করবেন এবং পরবর্তী বিভাগে আপনার অ্যাপের জন্য ক্লায়েন্ট কোড লিখতে সেগুলি ব্যবহার করবেন৷

6. স্টার্ট এমুলেটর বোতামে ক্লিক করুন।

   দ্রষ্টব্য: ইন্টিগ্রেটেড টার্মিনালে , আপনার কনফিগার করা এমুলেটরগুলি শুরু হয়েছে কিনা তা যাচাই করুন। একবার সেগুলি চালু হয়ে গেলে, আপনার এমুলেটর বিশদ সহ আপনার এক্সটেনশন UI আপডেট দেখতে হবে।

একটি স্কিমা তৈরি করুন

আপনার ফায়ারবেস প্রজেক্ট ডিরেক্টরিতে, /dataconnect/schema/schema.gql ফাইলে, সিনেমা সম্পর্কে একটি GraphQL স্কিমা সংজ্ঞায়িত করা শুরু করুন।

মুভি

Data Connect , গ্রাফকিউএল ক্ষেত্রগুলি কলামে ম্যাপ করা হয়। মুভিটির id , title , imageUrl এবং genre রয়েছে। Data Connect আদিম ডেটা প্রকারগুলিকে স্বীকৃতি দেয়: String এবং UUID ।

নিম্নলিখিত স্নিপেটটি অনুলিপি করুন বা ফাইলের সংশ্লিষ্ট লাইনগুলিকে আনকমেন্ট করুন।

# By default, a UUID id key will be created by default as primary key.
# If you want to specify a primary key, say title, which you can do through
# the @table(key: "title") directive
type Movie @table {
  id: UUID! @default(expr: "uuidV4()")
  title: String!
  imageUrl: String!
  genre: String
}

মুভি মেটাডেটা

নিম্নলিখিত স্নিপেটটি অনুলিপি করুন বা ফাইলের সংশ্লিষ্ট লাইনগুলিকে আনকমেন্ট করুন।

# Movie - MovieMetadata is a one-to-one relationship
type MovieMetadata @table {
  # This time, we omit adding a primary key because
  # you can rely on Data Connect to manage it.

  # @unique indicates a 1-1 relationship
  movie: Movie! @unique
  # movieId: UUID <- this is created by the above reference
  rating: Float
  releaseYear: Int
  description: String
}

লক্ষ্য করুন যে movie ক্ষেত্রটি একটি Movie সাথে ম্যাপ করা হয়েছে। Data Connect বোঝে যে এটি Movie এবং MovieMetadata মধ্যে একটি সম্পর্ক এবং আপনার জন্য এই সম্পর্কটি পরিচালনা করবে।

আপনার টেবিলে ডেটা যোগ করুন

VS কোড এডিটর প্যানেলে, আপনি /dataconnect/schema/schema.gql এ গ্রাফকিউএল প্রকারের উপর কোডলেন্স বোতামগুলি উপস্থিত দেখতে পাবেন। আপনি ডেটা যোগ করুন এবং রান (স্থানীয়) বোতামগুলি আপনার স্থানীয় ডাটাবেসে ডেটা যোগ করতে পারেন।

Movie এবং MovieMetadata টেবিলে রেকর্ড যোগ করতে:

1. schema.gql এ, Movie ধরন ঘোষণার উপরে ডেটা যোগ করুন বোতামে ক্লিক করুন।
   
2. Movie_insert.gql ফাইলে যেটি তৈরি হয়, তিনটি ক্ষেত্রের জন্য হার্ড কোড ডেটা।
3. রান (স্থানীয়) বোতামে ক্লিক করুন।
   
4. MovieMetadata টেবিলে একটি রেকর্ড যোগ করার জন্য পূর্ববর্তী পদক্ষেপগুলি পুনরাবৃত্তি করুন, movie ফিল্ডে আপনার মুভির uid সরবরাহ করুন, যেমন MovieMetadata_insert মিউটেশনে প্রম্পট করা হয়েছে।

দ্রুত তথ্য যাচাই করতে যোগ করা হয়েছে:

1. schema.gql এ ফিরে, ডেটা পড়ুন বোতামে ক্লিক করুন।
2. ফলস্বরূপ Movie_read.gql ফাইলে, কোয়েরি চালানোর জন্য রান (স্থানীয়) বোতামে ক্লিক করুন।

আপনার প্রশ্ন সংজ্ঞায়িত করুন

এখন মজার অংশ: আসুন আপনার অ্যাপ্লিকেশনে আপনার প্রয়োজনীয় প্রশ্নগুলি সংজ্ঞায়িত করি। একজন ডেভেলপার হিসেবে, আপনি GraphQL কোয়েরির পরিবর্তে SQL ক্যোয়ারী লিখতে অভ্যস্ত, তাই এটি প্রথমে কিছুটা আলাদা মনে হতে পারে। যাইহোক, GraphQL raw SQL এর চেয়ে অনেক বেশি পরিচ্ছন্ন এবং টাইপ-নিরাপদ। এবং আমাদের VS কোড এক্সটেনশন উন্নয়ন অভিজ্ঞতা সহজ করে.

/dataconnect/connector/queries.gql ফাইলটি সম্পাদনা করা শুরু করুন। আপনি যদি সব সিনেমা পেতে চান, এই মত একটি প্রশ্ন ব্যবহার করুন.

# File `/dataconnect/connector/queries.gql`

# @auth() directives control who can call each operation.
# Anyone should be able to list all movies, so the auth level is set to PUBLIC
query ListMovies @auth(level: PUBLIC) {
  movies {
    id
    title
    imageUrl
    genre
  }
}

কাছাকাছি কোডলেন্স বোতাম ব্যবহার করে ক্যোয়ারীটি চালান।

এখানে একটি সত্যিই উত্তেজনাপূর্ণ বৈশিষ্ট্য একটি গ্রাফ মত ডাটাবেসের সম্পর্ক আচরণ করার ক্ষমতা. যেহেতু একটি মুভিমেটাডেটার একটি movie ক্ষেত্র রয়েছে যা একটি মুভিকে উল্লেখ করে, আপনি ফিল্ডে নেস্ট করতে পারেন এবং মুভির তথ্য সম্পর্কে তথ্য ফিরে পেতে পারেন। ListMovies ক্যোয়ারীতে জেনারেট করা ধরনের movieMetadata_on_movie যোগ করার চেষ্টা করুন।

query ListMovies @auth(level: PUBLIC) {
  movies {
    id
    title
    imageUrl
    genre
    movieMetadata_on_movie {
        rating
    }
  }
}

SDK তৈরি করুন এবং আপনার অ্যাপে ব্যবহার করুন

আপনার ইচ্ছামত প্ল্যাটফর্ম প্রতি SDK কোড তৈরি করতে আপনার connector/connector.yaml ফাইল আপডেট করুন।

# File `/dataconnect/connector.yaml`

connectorId: movies
generate:
  javascriptSdk:
    outputDir: "../movies-generated"
    package: "@movie-app/movies"
    packageJsonDir: "../../"
  swiftSdk:
    outputDir: "../movies-generated"
    package: "Movies"
  kotlinSdk:
    outputDir: "../src/main/java/com/myapplication"
    package: "com.myapplication"

একবার আপনি connector.yaml এ আপনার সম্পাদনাগুলি সংরক্ষণ করলে, আপনি outputDir দ্বারা নির্দিষ্ট করা পরিচালকের অধীনে প্রতিটি প্ল্যাটফর্মের জন্য তৈরি করা কোড দেখতে পাবেন।

ক্লায়েন্ট অ্যাপস ( ওয়েব , অ্যান্ড্রয়েড , এবং iOS ) থেকে কল কোয়েরি এবং মিউটেশন করতে কীভাবে জেনারেট করা SDK ব্যবহার করবেন তা শিখুন।

উত্পাদনে আপনার স্কিমা এবং ক্যোয়ারী স্থাপন করুন

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

1. Firebase কনসোলের ডেটা কানেক্ট বিভাগে নেভিগেট করুন এবং একটি বিনামূল্যের ট্রায়াল ক্লাউড SQL দৃষ্টান্ত তৈরি করুন।

   দ্রষ্টব্য: PostgreSQL দৃষ্টান্তের জন্য আপনার ক্লাউড এসকিউএল-এর ব্যবস্থা করতে 15 মিনিট পর্যন্ত সময় লাগতে পারে। আপনার উদাহরণ প্রস্তুত না হওয়া পর্যন্ত আপনি স্থাপন করতে সক্ষম হবেন না। আপনি আপনার স্কিমা স্থাপন করার আগে, আপনাকে VSCode কে আপনার ক্লাউড এসকিউএল ইনস্ট্যান্স সেটআপ সম্পর্কে জানাতে হবে:

2. VS কোডে, /dataconnect/dataconnect.yaml ফাইলটি খুলুন এবং Firebase Data Connect পরিষেবা আইডি, অঞ্চল , ক্লাউড SQL ডাটাবেস এবং ফায়ারবেস কনসোলে যে ইনস্ট্যান্স আইডি নাম সেটআপ করেছেন তার সাথে serviceId, অবস্থান, ডাটাবেস এবং instanceId ক্ষেত্রগুলি আপডেট করুন৷

3. Data Connect VS Code Extension UI-তে, Deploy বাটনে ক্লিক করুন।

4. একবার স্থাপন করা হলে, ক্লাউডে আপলোড করা স্কিমা, অপারেশন এবং ডেটা যাচাই করতে Firebase কনসোলে যান। আপনি স্কিমা দেখতে সক্ষম হবেন এবং কনসোলে আপনার ক্রিয়াকলাপগুলিও চালাতে পারবেন। PostgreSQL দৃষ্টান্তের জন্য ক্লাউড এসকিউএল এর চূড়ান্ত স্থাপন করা জেনারেটেড স্কিমা এবং ডেটা সহ আপডেট করা হবে।

পরবর্তী পদক্ষেপ

টিপ: এই ওয়াকথ্রুটি কি আপনাকে ব্যক্তিগত পূর্বরূপ প্রোগ্রামে অংশগ্রহণ করতে আগ্রহী করেছে? যদি তাই হয়, Firebase Data Connect পণ্য পৃষ্ঠায় সাইন আপ করুন।