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

দ্রষ্টব্য: Firebase Data Connect সর্বজনীন প্রিভিউতে রয়েছে। Data Connect Google ক্লাউড প্ল্যাটফর্ম পরিষেবার শর্তাবলীর পরিষেবা নির্দিষ্ট শর্তাদি বিভাগে "প্রাক-GA অফারিং শর্তাবলী" এর অধীন হবে৷ প্রাক-GA বৈশিষ্ট্য "যেমন আছে" উপলভ্য এবং সীমিত সমর্থন থাকতে পারে। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন।

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

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

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

একটি কুইকস্টার্ট অ্যাপ রিপোজিটরি খুঁজুন এবং ওয়েবের জন্য আমাদের কোডল্যাব অনুসরণ করে একটি সম্পূর্ণ বৈশিষ্ট্যযুক্ত Data Connect অ্যাপ তৈরি করুন। অ্যান্ড্রয়েড এবং আইওএসের জন্য কোডল্যাব শীঘ্রই আসছে।

একটি স্থানীয় উন্নয়ন প্রবাহ চয়ন করুন

Data Connect আপনাকে ডেভেলপমেন্ট টুল ইনস্টল করার এবং স্থানীয়ভাবে কাজ করার দুটি উপায় অফার করে।

স্বয়ংক্রিয় ইনস্টলেশন (macOS বা Linux) ম্যানুয়াল ইনস্টলেশন (উইন্ডোজ)

পূর্বশর্ত

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

• একটি ফায়ারবেস প্রকল্প। আপনি যদি ইতিমধ্যে একটি তৈরি না করে থাকেন, তাহলে Firebase কনসোলে তা করুন৷

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

1. আপনার স্থানীয় প্রকল্পের জন্য একটি নতুন ডিরেক্টরি তৈরি করুন।

2. আপনার তৈরি করা নতুন ডিরেক্টরিতে নিম্নলিখিত কমান্ডটি চালান।

     curl -sL https://firebase.tools/dataconnect | bash

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

   দ্রষ্টব্য: আপনার যদি ইতিমধ্যেই VS কোডের ডেস্কটপ সংস্করণ ইনস্টল করা থাকে, তাহলে স্ক্রিপ্টটি স্বয়ংক্রিয়ভাবে খুলবে।
   দ্রষ্টব্য: স্ক্রিপ্ট ব্যর্থ হলে, ম্যানুয়াল ইনস্টলেশন পদক্ষেপগুলি ব্যবহার করুন৷

পরামর্শ: ঐচ্ছিকভাবে, আপনি আপনার শেল প্রোফাইলে (যেমন ~/.zshrc বা ~/.bash_profile ) নিম্নলিখিত লাইনটি যুক্ত করে একটি উপনাম সেট আপ করতে পারেন। এটি আপনাকে স্থানীয়ভাবে টুলিং আপগ্রেড করতে বা শুধুমাত্র dataconnect টাইপ করে ব্রাউজার-ভিত্তিক IDE পুনরায় চালু করতে দেয়।

alias dataconnect='curl -sL https://firebase.tools/dataconnect | bash'

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

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

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

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

   দ্রষ্টব্য: ইন্টিগ্রেটেড টার্মিনালে , আপনার কনফিগার করা এমুলেটরগুলি শুরু হয়েছে কিনা তা যাচাই করুন। একবার সেগুলি চালু হয়ে গেলে, আপনার এমুলেটর বিশদ সহ আপনার এক্সটেনশন 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 মধ্যে একটি সম্পর্ক এবং আপনার জন্য এই সম্পর্কটি পরিচালনা করবে।

ডকুমেন্টেশনে ডেটা কানেক্ট স্কিমা সম্পর্কে আরও জানুন

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

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

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

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

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

1. schema.gql এ ফিরে, Movie টাইপ ঘোষণার উপরে ডেটা পড়ুন বোতামে ক্লিক করুন।
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
  }
}

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

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

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

ডকুমেন্টেশনে ডেটা কানেক্ট কোয়েরি সম্পর্কে আরও জানুন

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

IDE বাম-হাতের প্যানেলে, Data Connect VS Code এক্সটেনশন UI খুলতে Firebase আইকনে ক্লিক করুন:

1. অ্যাপে SDK যোগ করুন বোতামে ক্লিক করুন।

2. প্রদর্শিত ডায়ালগে, আপনার অ্যাপের জন্য কোড ধারণকারী একটি ডিরেক্টরি নির্বাচন করুন। Data Connect SDK কোড তৈরি হবে এবং সেখানে সেভ করা হবে।

   দ্রষ্টব্য: আপনার যদি এখনও কোনো অ্যাপ ডিরেক্টরি না থাকে, তাহলে আপনি আপাতত SDK কোডের জন্য একটি নতুন ডিরেক্টরি তৈরি করতে এবং নির্বাচন করতে পারেন এবং পরে আপনার অ্যাপে লিঙ্ক করতে পারেন৷

3. আপনার অ্যাপ প্ল্যাটফর্ম নির্বাচন করুন, তারপর মনে রাখবেন যে আপনার নির্বাচিত ডিরেক্টরিতে SDK কোড অবিলম্বে তৈরি হয়েছে।

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

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

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

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

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

2. IDE ইন্টিগ্রেটেড টার্মিনালে , firebase init dataconnect চালান এবং কনসোলে আপনার তৈরি করা অঞ্চল/পরিষেবা আইডি নির্বাচন করুন।

3. "ফাইল dataconnect/dataconnect.yaml ইতিমধ্যেই বিদ্যমান, ওভাররাইট?" দিয়ে অনুরোধ করা হলে "Y" নির্বাচন করুন? .

4. IDE উইন্ডোতে, VS Code Extension UI-তে, Deploy to Production বোতামে ক্লিক করুন।

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

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

আপনার নিয়োজিত প্রকল্প পর্যালোচনা করুন এবং আরও সরঞ্জাম আবিষ্কার করুন:

• আপনার ডাটাবেসে ডেটা যোগ করুন, আপনার স্কিমাগুলি পরিদর্শন করুন এবং সংশোধন করুন এবং Firebase কনসোলে আপনার ডেটা কানেক্ট পরিষেবা নিরীক্ষণ করুন।

ডকুমেন্টেশনে আরও তথ্য অ্যাক্সেস করুন। উদাহরণস্বরূপ, যেহেতু আপনি কুইকস্টার্ট সম্পূর্ণ করেছেন:

• স্কিমা, ক্যোয়ারী এবং মিউটেশন ডেভেলপমেন্ট সম্পর্কে আরও জানুন
• ক্লায়েন্ট SDK তৈরি করা এবং ওয়েব , Android , এবং iOS এবং ফ্লটারের জন্য ক্লায়েন্ট কোড থেকে কলিং কোয়েরি এবং মিউটেশন সম্পর্কে জানুন।