Watch demos on how to build & run AI-powered apps with Firebase at Demo Day '24. Watch now.

এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

Firebase Data Connect দিয়ে শুরু করুন

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

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

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

পূর্বশর্ত

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

লিনাক্স, ম্যাকওএস বা উইন্ডোজ
ভিজ্যুয়াল স্টুডিও কোড

আপনার Firebase প্রকল্পের সাথে সংযোগ করুন

যদি আপনি ইতিমধ্যেই না করে থাকেন, তাহলে একটি Firebase প্রকল্প তৈরি করুন৷
1. Firebase কনসোলে , প্রজেক্ট যোগ করুন ক্লিক করুন, তারপর অন-স্ক্রীন নির্দেশাবলী অনুসরণ করুন।
Firebase কনসোলের Data Connect বিভাগে নেভিগেট করুন এবং পণ্য সেটআপ ওয়ার্কফ্লো অনুসরণ করুন।
আপনার প্রকল্পকে ব্লেজ প্ল্যানে আপগ্রেড করুন। এটি আপনাকে PostgreSQL উদাহরণের জন্য একটি ক্লাউড SQL তৈরি করতে দেয়।
দ্রষ্টব্য: যদিও আপনি আপনার ব্লেজ আপগ্রেডে বিলিং সেট আপ করেছেন, তবে প্রিভিউ চলাকালীন পোস্টগ্রেএসকিউএল কনফিগারেশনের জন্য Data Connect বা ডিফল্ট ক্লাউড এসকিউএল ব্যবহারের জন্য আপনাকে চার্জ করা হবে না।
PostgreSQL ডাটাবেসের জন্য আপনার CloudSQL-এর জন্য একটি অবস্থান নির্বাচন করুন।
পরে নিশ্চিতকরণের জন্য প্রকল্প, পরিষেবা এবং ডাটাবেসের নাম এবং আইডি নোট করুন।
অবশিষ্ট সেটআপ ফ্লো অনুসরণ করুন তারপর সম্পন্ন ক্লিক করুন।
দ্রষ্টব্য: PostgreSQL দৃষ্টান্তের জন্য আপনার ক্লাউড SQL-এর ব্যবস্থা করা শেষ করতে 15 মিনিট পর্যন্ত সময় লাগতে পারে। আপনি Google Cloud কনসোল ব্যবহার করে ডেটাবেস প্রভিশনিং সহ Data Connect সেটআপ প্রবাহ সম্পূর্ণ হয়েছে তা নিশ্চিত করতে পারেন৷

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

Data Connect উন্নয়নের জন্য দুটি উন্নয়ন অভিজ্ঞতা সমর্থন করে:

আপনি যদি একজন Kotlin Android , iOS , Flutter , বা ওয়েব ডেভেলপার হন, তাহলে আপনি PostgreSQL দৃষ্টান্তের জন্য আপনার ক্লাউড SQL এর সাথে সংযোগ করার সময় স্থানীয়ভাবে স্কিমা এবং অপারেশনগুলি ডিজাইন এবং পরীক্ষা করতে VS কোড বিকাশ ব্যবহার করতে পারেন৷
আপনি যদি একজন ওয়েব ডেভেলপার হন, তাহলে আপনি IDX ডেভেলপমেন্ট ব্যবহার করতে পারেন একটি IDX ওয়ার্কস্পেসে প্রোটোটাইপ করার জন্য PostgreSQL এর সাথে একটি প্রি-কনফিগার করা IDX টেমপ্লেট, Data Connect এমুলেটরের সাথে VS কোড এক্সটেনশন এবং আপনার জন্য সেট আপ করা কুইকস্টার্ট ক্লায়েন্ট কোড। আপনি Project IDX সাইটে আরও তথ্য পাবেন।

এই কুইকস্টার্টটি ভিএস কোড এক্সটেনশন ডেভেলপমেন্ট ফ্লোতে ফোকাস করে। চালিয়ে যেতে:

আপনার স্থানীয় প্রকল্পের জন্য একটি নতুন ডিরেক্টরি তৈরি করুন।
নতুন ডিরেক্টরিতে VS কোড খুলুন।
ভিজ্যুয়াল স্টুডিও কোড মার্কেটপ্লেস থেকে ফায়ারবেস ডেটা কানেক্ট এক্সটেনশন ইনস্টল করুন।
দ্রষ্টব্য: এক্সটেনশনটিতে মার্কেটপ্লেস গ্রাফকিউএল সিনট্যাক্স হাইলাইটিং এক্সটেনশন অন্তর্ভুক্ত রয়েছে। আপনার ইনস্টল করা অন্যান্য GraphQL এক্সটেনশনগুলি Firebase Data Connect এক্সটেনশনে বান্ডিল করা GraphQL সমর্থনের সাথে বিরোধ করতে পারে।

আপনার স্থানীয় প্রকল্প সেট আপ করুন

সাধারণ নির্দেশাবলী অনুসরণ করে CLI ইনস্টল করুন। আপনার যদি ইতিমধ্যেই npm ইনস্টল করা থাকে তবে নিম্নলিখিত কমান্ডটি চালান:

npm install -g firebase-tools

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

আপনার স্থানীয় প্রকল্প সেট আপ করতে, আপনার প্রকল্প ডিরেক্টরি শুরু করুন.

VS Code বামদিকের প্যানেলে, Firebase VS Code এক্সটেনশন UI খুলতে Firebase আইকনে ক্লিক করুন।

সাইন ইন উইথ গুগল বোতামে ক্লিক করুন।
একটি ফায়ারবেস প্রকল্প সংযুক্ত করুন বোতামে ক্লিক করুন এবং কনসোলে আপনি আগে তৈরি করা প্রকল্পটি নির্বাচন করুন৷
রান ফায়ারবেস ইনিট বোতামে ক্লিক করুন।
যদি আপনার প্রজেক্টটি ব্লেজ প্ল্যানে থাকে, যখন অনুরোধ করা হয় "আপনি কি এখন আপনার ব্যাকএন্ড সংস্থানগুলি কনফিগার করতে চান?", উত্তর দিন "হ্যাঁ" ৷
স্টার্ট এমুলেটর বোতামে ক্লিক করুন।
দ্রষ্টব্য: ইন্টিগ্রেটেড টার্মিনালে, আপনার কনফিগার করা এমুলেটরগুলি শুরু হয়েছে কিনা তা যাচাই করুন। একবার সেগুলি চালু হয়ে গেলে, আপনার এমুলেটর বিশদ সহ আপনার এক্সটেনশন UI আপডেট দেখতে হবে।

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

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

মুভি

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

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

# File `/dataconnect/schema/schema.gql`

# By default, a UUID id key will be created by default as primary key.
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 মধ্যে একটি সম্পর্ক এবং আপনার জন্য এই সম্পর্কটি পরিচালনা করবে।

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

উত্পাদনে আপনার স্কিমা স্থাপন করুন

আপনি যদি আপনার প্রোডাকশন ডাটাবেসের সাথে কাজ করার জন্য Firebase VS কোড এক্সটেনশন ব্যবহার করেন, তাহলে চালিয়ে যাওয়ার আগে আপনাকে আপনার স্কিমা স্থাপন করতে হবে। আপনার প্রোডাকশন ডাটাবেসে আপনার স্কিমা স্থাপন করার পরে, আপনি কনসোলে স্কিমা দেখতে সক্ষম হবেন।

দ্রষ্টব্য: PostgreSQL দৃষ্টান্তের জন্য আপনার ক্লাউড এসকিউএল-এর ব্যবস্থা করতে 15 মিনিট পর্যন্ত সময় লাগতে পারে। আপনার উদাহরণ প্রস্তুত না হওয়া পর্যন্ত আপনি স্থাপন করতে সক্ষম হবেন না। আপনি আপনার স্কিমা স্থাপন করার আগে, Google Cloud কনসোল ব্যবহার করে ডেটাবেস প্রভিশনিং সহ Data Connect সেটআপ প্রবাহ সম্পূর্ণ হয়েছে তা নিশ্চিত করুন৷

আপনি স্থাপন করতে ডেটা কানেক্ট VS কোড এক্সটেনশন ব্যবহার করতে পারেন।
- এক্সটেনশন UI-তে, Firebase Data Connect প্যানেলের অধীনে, Deploy to Production-এ ক্লিক করুন।
আপনাকে স্কিমা পরিবর্তনগুলি পর্যালোচনা করতে এবং সম্ভাব্য ধ্বংসাত্মক পরিবর্তনগুলি অনুমোদন করতে হতে পারে৷ আপনাকে অনুরোধ করা হবে:
- firebase dataconnect:sql:diff ব্যবহার করে স্কিমা পরিবর্তন পর্যালোচনা করুন
- আপনি যখন পরিবর্তন নিয়ে সন্তুষ্ট হন, তখন firebase dataconnect:sql:migrate দ্বারা শুরু হওয়া ফ্লো ব্যবহার করে সেগুলি প্রয়োগ করুন।

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

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

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

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

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

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

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

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

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

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

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

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

আপনি একটি উন্নয়ন পুনরাবৃত্তি মাধ্যমে কাজ করেছেন. এখন আপনি আপনার স্কিমা, ডেটা এবং প্রশ্নগুলিকে Firebase এক্সটেনশন UI বা Firebase CLI দিয়ে সার্ভারে স্থাপন করতে পারেন, ঠিক যেমন আপনি আপনার স্কিমার সাথে করেছিলেন৷

আপনি যদি ফায়ারবেস ভিএস কোড এক্সটেনশন ব্যবহার করেন তাহলে প্রোডাকশনে ডিপ্লোয় বোতামে ক্লিক করুন।

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

ডকুমেন্টেশনে ডেটা কানেক্ট এমুলেটর ব্যবহার সম্পর্কে আরও জানুন

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

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

আপনার ডাটাবেসে ডেটা যোগ করুন, আপনার স্কিমাগুলি পরিদর্শন করুন এবং সংশোধন করুন এবং Firebase কনসোলে আপনার ডেটা কানেক্ট পরিষেবা নিরীক্ষণ করুন। ডকুমেন্টেশনে আরও তথ্য অ্যাক্সেস করুন। উদাহরণস্বরূপ, যেহেতু আপনি কুইকস্টার্ট সম্পূর্ণ করেছেন:
স্কিমা, ক্যোয়ারী এবং মিউটেশন ডেভেলপমেন্ট সম্পর্কে আরও জানুন
ক্লায়েন্ট SDK তৈরি করা এবং ওয়েব , অ্যান্ড্রয়েড , iOS এবং ফ্লটারের জন্য ক্লায়েন্ট কোড থেকে কলিং কোয়েরি এবং মিউটেশন সম্পর্কে জানুন।

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