স্প্যানার ক্যাসান্দ্রা অ্যাডাপ্টারের সাথে শুরু করা,স্প্যানার ক্যাসান্দ্রা অ্যাডাপ্টারের সাথে শুরু করা,স্প্যানার ক্যাসান্দ্রা অ্যাডাপ্টারের সাথে শুরু করা

Spanner Cassandra Adapter দিয়ে শুরু করা হচ্ছে

এই কোডল্যাব সম্পর্কে

মে ২১, ২০২৫-এ শেষবার আপডেট করা হয়েছে

Mayur Kale, Vardhan Thigle-এর লেখা

1. ভূমিকা

স্প্যানার হল একটি সম্পূর্ণরূপে পরিচালিত, অনুভূমিকভাবে স্কেলযোগ্য, বিশ্বব্যাপী বিতরণ করা ডাটাবেস পরিষেবা যা রিলেশনাল এবং অ-রিলেশনাল ওয়ার্কলোডের জন্য দুর্দান্ত।

স্প্যানারের ক্যাসান্ড্রা ইন্টারফেস আপনাকে পরিচিত ক্যাসান্ড্রা টুল এবং সিনট্যাক্স ব্যবহার করে স্প্যানারের সম্পূর্ণরূপে পরিচালিত, মাপযোগ্য, এবং অত্যন্ত উপলব্ধ পরিকাঠামোর সুবিধা নিতে দেয়।

আপনি কি শিখবেন

• কিভাবে একটি স্প্যানার ইনস্ট্যান্স এবং ডাটাবেস সেটআপ করবেন।
• আপনার ক্যাসান্দ্রা স্কিমা এবং ডেটা মডেল কীভাবে রূপান্তর করবেন।
• ইনকামিং ডেটার জন্য ডুয়াল রাইট কীভাবে স্থাপন এবং কনফিগার করবেন।
• ক্যাসান্দ্রা থেকে স্প্যানারে কীভাবে আপনার ঐতিহাসিক ডেটা বাল্ক এক্সপোর্ট করবেন।
• মাইগ্রেশন প্রক্রিয়া জুড়ে ডেটা অখণ্ডতা নিশ্চিত করতে কীভাবে ডেটা যাচাই করবেন।
• ক্যাসান্দ্রার পরিবর্তে কীভাবে আপনার আবেদনটি স্প্যানারে নির্দেশ করবেন।

আপনি কি প্রয়োজন হবে

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

2. সেটআপ এবং প্রয়োজনীয়তা

দ্রষ্টব্য: আপনি এই ধাপটি এড়িয়ে যেতে পারেন যদি আপনার কাছে আগে থেকেই বিলিং সক্ষম করে একটি GCP প্রকল্প থাকে।

একটি GCP প্রকল্প তৈরি করুন

Google ক্লাউড কনসোলে সাইন-ইন করুন এবং একটি নতুন প্রকল্প তৈরি করুন বা বিদ্যমান একটি পুনরায় ব্যবহার করুন৷ আপনার যদি ইতিমধ্যেই একটি Gmail বা Google Workspace অ্যাকাউন্ট না থাকে, তাহলে আপনাকে অবশ্যই একটি তৈরি করতে হবে।

• প্রকল্পের নাম এই প্রকল্পের অংশগ্রহণকারীদের জন্য প্রদর্শনের নাম। এটি একটি অক্ষর স্ট্রিং যা Google API দ্বারা ব্যবহৃত হয় না। আপনি সবসময় এটি আপডেট করতে পারেন.
• প্রোজেক্ট আইডি সমস্ত Google ক্লাউড প্রোজেক্ট জুড়ে অনন্য এবং অপরিবর্তনীয় (সেট করার পরে পরিবর্তন করা যাবে না)। ক্লাউড কনসোল স্বয়ংক্রিয়ভাবে একটি অনন্য স্ট্রিং তৈরি করে; সাধারণত আপনি এটা কি যত্ন না. বেশিরভাগ কোডল্যাবে, আপনাকে আপনার প্রকল্প আইডি উল্লেখ করতে হবে (সাধারণত PROJECT_ID হিসাবে চিহ্নিত)। আপনি যদি জেনারেট করা আইডি পছন্দ না করেন, তাহলে আপনি অন্য একটি এলোমেলো আইডি তৈরি করতে পারেন। বিকল্পভাবে, আপনি নিজের চেষ্টা করতে পারেন, এবং এটি উপলব্ধ কিনা দেখতে পারেন। এই ধাপের পরে এটি পরিবর্তন করা যাবে না এবং প্রকল্পের সময়কালের জন্য থাকে।
• আপনার তথ্যের জন্য, একটি তৃতীয় মান আছে, একটি প্রকল্প নম্বর , যা কিছু API ব্যবহার করে। ডকুমেন্টেশনে এই তিনটি মান সম্পর্কে আরও জানুন।

সতর্কতা: একটি প্রকল্প আইডি বিশ্বব্যাপী অনন্য এবং আপনি এটি নির্বাচন করার পরে অন্য কেউ ব্যবহার করতে পারবেন না। আপনি সেই আইডির একমাত্র ব্যবহারকারী। এমনকি একটি প্রকল্প মুছে ফেলা হলেও, আইডিটি আবার ব্যবহার করা যাবে না

দ্রষ্টব্য: আপনি যদি একটি Gmail অ্যাকাউন্ট ব্যবহার করেন, আপনি ডিফল্ট অবস্থানটি কোন প্রতিষ্ঠানে সেট করতে পারেন। আপনি যদি একটি Google Workspace অ্যাকাউন্ট ব্যবহার করেন, তাহলে এমন একটি লোকেশন বেছে নিন যা আপনার প্রতিষ্ঠানের জন্য উপযুক্ত।

বিলিং সেটআপ

এর পরে, আপনাকে বিলিং ব্যবহারকারী নির্দেশিকা পরিচালনা করতে হবে এবং ক্লাউড কনসোলে বিলিং সক্ষম করতে হবে। নতুন Google ক্লাউড ব্যবহারকারীরা $300 USD বিনামূল্যের ট্রায়াল প্রোগ্রামের জন্য যোগ্য৷ এই টিউটোরিয়ালের বাইরে বিলিং এড়াতে, আপনি "ধাপ 9 পরিষ্কার করা" অনুসরণ করে কোডল্যাবের শেষে স্প্যানার ইনস্ট্যান্স বন্ধ করতে পারেন।

ক্লাউড শেল শুরু করুন

যদিও Google ক্লাউড আপনার ল্যাপটপ থেকে দূরবর্তীভাবে পরিচালিত হতে পারে, এই কোডল্যাবে আপনি Google ক্লাউড শেল ব্যবহার করবেন, একটি কমান্ড লাইন পরিবেশ যা ক্লাউডে চলছে।

Google ক্লাউড কনসোল থেকে, উপরের ডানদিকে টুলবারে ক্লাউড শেল আইকনে ক্লিক করুন:

পরিবেশের ব্যবস্থা করতে এবং সংযোগ করতে এটি শুধুমাত্র কয়েক মুহূর্ত নিতে হবে। এটি সমাপ্ত হলে, আপনি এই মত কিছু দেখতে হবে:

এই ভার্চুয়াল মেশিনটি আপনার প্রয়োজনীয় সমস্ত ডেভেলপমেন্ট টুল দিয়ে লোড করা হয়েছে। এটি একটি ক্রমাগত 5GB হোম ডিরেক্টরি অফার করে এবং Google ক্লাউডে চলে, যা নেটওয়ার্ক কর্মক্ষমতা এবং প্রমাণীকরণকে ব্যাপকভাবে উন্নত করে। এই কোডল্যাবে আপনার সমস্ত কাজ একটি ব্রাউজারে করা যেতে পারে। আপনার কিছু ইন্সটল করার দরকার নেই।

পরবর্তী আপ

এর পরে, আপনি ক্যাসান্দ্রা ক্লাস্টার স্থাপন করবেন।

3. ক্যাসান্দ্রা ক্লাস্টার স্থাপন করুন (উৎস)

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

এই কোডল্যাবের জন্য, আমরা কম্পিউট ইঞ্জিনে একটি একক-নোড ক্যাসান্দ্রা ক্লাস্টার সেট আপ করব।

1. ক্যাসান্দ্রার জন্য একটি GCE VM তৈরি করুন৷

একটি উদাহরণ তৈরি করতে, gcloud compute instances create কমান্ডটি ব্যবহার করুন।

gcloud compute instances create cassandra-origin \
--machine-type=e2-medium \
--image-family=ubuntu-2004-lts \
--image-project=ubuntu-os-cloud \
--tags=cassandra-migration \
--boot-disk-size=20GB

2. ক্যাসান্ড্রা ইনস্টল করুন

# Install Java (Cassandra dependency)
sudo apt-get update
sudo apt-get install -y openjdk-11-jre-headless

# Add Cassandra repository
echo "deb [https://debian.cassandra.apache.org](https://debian.cassandra.apache.org) 41x main" | sudo tee -a /etc/apt/sources.list.d/cassandra.sources.list
curl [https://downloads.apache.org/cassandra/KEYS](https://downloads.apache.org/cassandra/KEYS) | sudo apt-key add -

# Install Cassandra
sudo apt-get update
sudo apt-get install -y cassandra

3. একটি কীস্পেস এবং টেবিল তৈরি করুন

আমরা একটি ব্যবহারকারী টেবিল উদাহরণ ব্যবহার করব এবং "বিশ্লেষণ" নামে একটি কীস্পেস তৈরি করব।

cd ~/apache-cassandra
bin/cqlsh <your-localhost-ip? 9042  #starts the cql shell

cqlsh এর ভিতরে:

-- Create keyspace (adjust replication for production)
CREATE KEYSPACE analytics WITH replication = {'class':'SimpleStrategy', 'replication_factor':1};

-- Use the keyspace
USE analytics;

-- Create the users table
CREATE TABLE users (
    id  int PRIMARY KEY,
    active  boolean,
    username  text,
);

-- Exit cqlsh
EXIT;

SSH সেশন খোলা রাখুন বা এই VM (হোস্টনেম -I) এর IP ঠিকানাটি নোট করুন।

পরবর্তী আপ

এর পরে, আপনি একটি ক্লাউড স্প্যানার ইনস্ট্যান্স এবং ডেটাবেস সেটআপ করবেন।

4. একটি স্প্যানার উদাহরণ এবং ডাটাবেস তৈরি করুন (লক্ষ্য)

দ্রষ্টব্য: আপনি এই ধাপটি এড়িয়ে যেতে পারেন যদি আপনার প্রকল্পে পরীক্ষার উদ্দেশ্যে আপনার কাছে ইতিমধ্যেই একটি স্প্যানার উদাহরণ থাকে। আপনি এই কনসোল লিঙ্কে গিয়ে যাচাই করতে পারেন

স্প্যানারে, একটি উদাহরণ হল কম্পিউটিং এবং স্টোরেজ সংস্থানগুলির একটি ক্লাস্টার যা এক বা একাধিক স্প্যানার ডাটাবেস হোস্ট করে। এই কোডল্যাবের জন্য একটি স্প্যানার ডাটাবেস হোস্ট করতে আপনার কমপক্ষে 1টি উদাহরণের প্রয়োজন হবে৷

জিক্লাউড এসডিকে সংস্করণ পরীক্ষা করুন

একটি উদাহরণ তৈরি করার আগে, নিশ্চিত করুন যে Google ক্লাউড শেলের gcloud SDK প্রয়োজনীয় সংস্করণে আপডেট করা হয়েছে - gcloud SDK 493.0.0 । আপনি নীচের কমান্ড অনুসরণ করে আপনার gcloud SDK সংস্করণ খুঁজে পেতে পারেন।

$ gcloud version | grep Google

এখানে একটি উদাহরণ আউটপুট:

Google Cloud SDK 489.0.0

আপনি যে সংস্করণটি ব্যবহার করছেন তা যদি প্রয়োজনীয় 493.0.0 সংস্করণের (পূর্ববর্তী উদাহরণে 489.0.0 ) এর চেয়ে আগের হয় তবে আপনাকে নিম্নলিখিত কমান্ডটি চালিয়ে আপনার Google ক্লাউড SDK আপগ্রেড করতে হবে:

sudo apt-get update \
  && sudo apt-get --only-upgrade install google-cloud-cli-anthoscli google-cloud-cli-cloud-run-proxy kubectl google-cloud-cli-skaffold google-cloud-cli-cbt google-cloud-cli-docker-credential-gcr google-cloud-cli-spanner-migration-tool google-cloud-cli-cloud-build-local google-cloud-cli-pubsub-emulator google-cloud-cli-app-engine-python google-cloud-cli-kpt google-cloud-cli-bigtable-emulator google-cloud-cli-datastore-emulator google-cloud-cli-spanner-emulator google-cloud-cli-app-engine-go google-cloud-cli-app-engine-python-extras google-cloud-cli-config-connector google-cloud-cli-package-go-module google-cloud-cli-istioctl google-cloud-cli-anthos-auth google-cloud-cli-gke-gcloud-auth-plugin google-cloud-cli-app-engine-grpc google-cloud-cli-kubectl-oidc google-cloud-cli-terraform-tools google-cloud-cli-nomos google-cloud-cli-local-extract google-cloud-cli-firestore-emulator google-cloud-cli-harbourbridge google-cloud-cli-log-streaming google-cloud-cli-minikube google-cloud-cli-app-engine-java google-cloud-cli-enterprise-certificate-proxy google-cloud-cli

দ্রষ্টব্য: পূর্ববর্তী কমান্ড নিরাপত্তার কারণে আপগ্রেড করা প্যাকেজগুলিকে সম্পূর্ণরূপে তালিকাভুক্ত করে।

স্প্যানার API সক্ষম করুন

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

gcloud config get-value project

gcloud config set project [YOUR-DESIRED-PROJECT-ID]

us-central1 এ আপনার ডিফল্ট অঞ্চল কনফিগার করুন। স্প্যানার আঞ্চলিক কনফিগারেশন দ্বারা সমর্থিত একটি ভিন্ন অঞ্চলে এটিকে নির্দ্বিধায় পরিবর্তন করুন৷

gcloud config set compute/region us-central1

স্প্যানার API সক্ষম করুন:

gcloud services enable spanner.googleapis.com

স্প্যানার উদাহরণ তৈরি করুন

এই বিভাগে, আপনি একটি ফ্রি ট্রায়াল ইনস্ট্যান্স বা একটি প্রভিশনড ইনস্ট্যান্স তৈরি করবেন। এই কোডল্যাব জুড়ে, স্প্যানার ক্যাসান্দ্রা অ্যাডাপ্টার ইনস্ট্যান্স আইডিটি হল cassandra-adapter-demo , export কমান্ড লাইন ব্যবহার করে SPANNER_INSTANCE_ID ভেরিয়েবল হিসাবে সেট করা হয়েছে। ঐচ্ছিকভাবে, আপনি নিজের ইন্সট্যান্স আইডি নাম বেছে নিতে পারেন।

একটি ফ্রি-ট্রায়াল স্প্যানার ইনস্ট্যান্স তৈরি করুন

একটি স্প্যানার 90-দিনের বিনামূল্যের ট্রায়াল ইনস্ট্যান্স একটি Google অ্যাকাউন্ট সহ যে কেউ তাদের প্রকল্পে ক্লাউড বিলিং সক্ষম করা আছে তাদের জন্য উপলব্ধ৷ আপনি চার্জ করা হবে না যদি না আপনি আপনার বিনামূল্যের ট্রায়াল ইনস্ট্যান্সকে একটি প্রদত্ত দৃষ্টান্তে আপগ্রেড করতে চান৷ স্প্যানার ক্যাসান্দ্রা অ্যাডাপ্টার বিনামূল্যে ট্রায়াল উদাহরণে সমর্থিত। যোগ্য হলে, ক্লাউড শেল খুলে এই কমান্ডটি চালিয়ে একটি বিনামূল্যের ট্রায়ালের উদাহরণ তৈরি করুন:

export SPANNER_INSTANCE_ID=cassandra-adapter-demo
export SPANNER_REGION=regional-us-central1
gcloud spanner instances create $SPANNER_INSTANCE_ID \
  --config=$SPANNER_REGION \
  --instance-type=free-instance \
  --description="Spanner Cassandra Adapter demo"

দ্রষ্টব্য: এই কমান্ডটি অঞ্চল হিসাবে regional-us-central1 ব্যবহার করে। স্প্যানার ফ্রি ট্রায়াল ইনস্ট্যান্সে উপলব্ধ অঞ্চল কনফিগারেশনের উপর ভিত্তি করে আপনি একটি ভিন্ন অঞ্চল নির্বাচন করতে পারেন৷ এখানে বিনামূল্যে ট্রায়াল ইনস্ট্যান্স কিভাবে তৈরি করতে হয় সে সম্পর্কে আরও পড়ুন।

কমান্ড আউটপুট:

$ gcloud spanner instances create $SPANNER_INSTANCE_ID \
  --config=$SPANNER_REGION \
  --instance-type=free-instance \
  --description="Spanner Cassandra Adapter demo"
Creating instance...done.

ডাটাবেস তৈরি করুন

একবার আপনার দৃষ্টান্ত চালু হলে, আপনি ডাটাবেস তৈরি করতে পারেন। ডাটাবেস হল যেখানে আপনি আপনার স্কিমা সংজ্ঞায়িত করেন। আপনি ডাটাবেসে কার অ্যাক্সেস আছে তা নিয়ন্ত্রণ করতে পারেন, কাস্টম এনক্রিপশন সেট আপ করতে পারেন, অপ্টিমাইজার কনফিগার করতে পারেন এবং ধরে রাখার সময়কাল সেট করতে পারেন।

SPANNER_INSTANCE_ID আইডি দিয়ে ডাটাবেস তৈরি করা হবে।

একটি ডাটাবেস তৈরি করতে, gcloud কমান্ড লাইন টুল ব্যবহার করুন:

export SPANNER_DATABASE=analytics
gcloud spanner databases create $SPANNER_DATABASE \
 --instance=$SPANNER_INSTANCE_ID

কমান্ড আউটপুট:

$ gcloud spanner databases create $SPANNER_DATABASE \
 --instance=$SPANNER_INSTANCE_ID
Creating database...done.

5. ক্যাসান্দ্রা স্কিমা এবং ডেটা মডেল স্প্যানারে স্থানান্তর করুন

ক্যাসান্ড্রা ডাটাবেস থেকে স্প্যানারে ডেটা স্থানান্তরের প্রাথমিক এবং গুরুত্বপূর্ণ ধাপে স্প্যানারের কাঠামোগত এবং ডেটা টাইপ প্রয়োজনীয়তার সাথে সারিবদ্ধ করার জন্য বিদ্যমান ক্যাসান্দ্রা স্কিমাকে রূপান্তর করা জড়িত।

এই জটিল স্কিমা মাইগ্রেশন প্রক্রিয়াটিকে স্ট্রীমলাইন করার জন্য, স্প্যানার একটি মূল্যবান ওপেন-সোর্স টুল সরবরাহ করে যা স্প্যানার ক্যাসান্দ্রা স্কিমা টুল নামে পরিচিত।

স্প্যানার ক্যাসান্দ্রা স্কিমা টুল

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

ক্যাসান্দ্রা স্কিমা রপ্তানি করুন

স্প্যানার ক্যাসান্দ্রা স্কিমা টুল ব্যবহার করার আগে, প্রথম কংক্রিট পদক্ষেপ হল আপনার বর্তমান ক্যাসান্দ্রা ক্লাস্টার থেকে স্কিমা বের করা। এটি cqlsh মাধ্যমে আপনার বিদ্যমান ক্যাসান্দ্রা ক্লাস্টারের সাথে সংযোগ করে এবং ক্যাসান্দ্রা থেকে স্কিমা রপ্তানি করে অর্জন করা যেতে পারে:

cqlsh [IP] "-e DESC SCHEMA" > orig_schema.cql

এই কমান্ডে, আপনার Cassandra ক্লাস্টারের একটি নোডের IP ঠিকানা বা হোস্টনাম দিয়ে [IP] প্রতিস্থাপন করা উচিত। কমান্ডের -e DESC SCHEMA অংশটি cqlsh কে ক্যাসান্ড্রা ক্লাস্টারের সম্পূর্ণ স্কিমা বর্ণনা করার নির্দেশ দেয়। এই কমান্ডের আউটপুট, যাতে CREATE KEYSPACE এবং CREATE TABLE স্টেটমেন্ট থাকে, তারপর orig_schema.cql নামের একটি ফাইলে রিডাইরেক্ট করা হয়।

এই orig_schema.cql ফাইলের বিষয়বস্তু মূলত আপনার ক্যাসান্দ্রা স্কিমার একটি পাঠ্য ব্লুপ্রিন্ট উপস্থাপন করবে। orig_schema.cql ফাইলের বিষয়বস্তু এইরকম হওয়া উচিত:

CREATE KEYSPACE analytics WITH replication = {'class': 'SimpleStrategy', 'replication_factor': '1'}  AND durable_writes = true;

CREATE TABLE analytics.users (
    id int PRIMARY KEY,
    active boolean,
    username text
) WITH additional_write_policy = '99p'
    AND allow_auto_snapshot = true
    AND bloom_filter_fp_chance = 0.01
    AND caching = {'keys': 'ALL', 'rows_per_partition': 'NONE'}
    AND cdc = false
    AND comment = ''
    AND compaction = {'class': 'org.apache.cassandra.db.compaction.SizeTieredCompactionStrategy', 'max_threshold': '32', 'min_threshold': '4'}
    AND compression = {'chunk_length_in_kb': '16', 'class': 'org.apache.cassandra.io.compress.LZ4Compressor'}
    AND memtable = 'default'
    AND crc_check_chance = 1.0
    AND default_time_to_live = 0
    AND extensions = {}
    AND gc_grace_seconds = 864000
    AND incremental_backups = true
    AND max_index_interval = 2048
    AND memtable_flush_period_in_ms = 0
    AND min_index_interval = 128
    AND read_repair = 'BLOCKING'
    AND speculative_retry = '99p';

সংগ্রহস্থল ক্লোন করুন

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

git clone https://github.com/cloudspannerecosystem/spanner-cassandra-schema-tool.git

তারপরে "স্প্যানার-ক্যাসান্ড্রা-স্কিমা-টুল" ডিরেক্টরিতে ডিরেক্টরি পরিবর্তন করুন যেখানে আপনি কমান্ডটি চালাবেন।

cd spanner-cassandra-schema-tool

নির্ভরতা ইনস্টল করুন

স্প্যানার ক্যাসান্দ্রা স্কিমা টুলটি গো প্রোগ্রামিং ভাষায় লেখা। টুল ফাংশন সঠিকভাবে নিশ্চিত করতে, এটি নির্দিষ্ট বাহ্যিক Go মডিউল (লাইব্রেরি) উপর নির্ভর করে। আপনি টুলটি চালানোর আগে এই নির্ভরতাগুলি ডাউনলোড এবং পরিচালনা করতে হবে। spanner-cassandra-schema-tool ডিরেক্টরির মধ্যে, নিম্নলিখিত কমান্ডটি চালান:

go mod download

Google ক্লাউড শংসাপত্র সেট আপ করুন৷

এই টুলটি স্প্যানার ডাটাবেসের সাথে সংযোগ করার জন্য শংসাপত্রের উৎস হিসাবে অ্যাপ্লিকেশন ডিফল্ট শংসাপত্র (ADC) ব্যবহার করে। আপনার পরিষেবা অ্যাকাউন্ট কী ফাইলের পাথে GOOGLE_APPLICATION_CREDENTIALS পরিবেশ পরিবর্তনশীল সেট করুন৷

export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/service-account-file.json"

/path/to/your/service-account-file.json আপনার ডাউনলোড করা সার্ভিস অ্যাকাউন্ট কী ফাইলের প্রকৃত পাথ দিয়ে প্রতিস্থাপন করুন। এই এনভায়রনমেন্ট ভেরিয়েবল সেট করা নিশ্চিত করে যে স্প্যানার ক্যাসান্ড্রা স্কিমা টুলটি আপনার Google ক্লাউড প্রোজেক্ট এবং স্প্যানার ইনস্ট্যান্সের সাথে নিরাপদে প্রমাণীকরণ করতে পারে।

ব্যবহার

নির্ভরতাগুলি ইনস্টল হয়ে গেলে এবং Google ক্লাউড শংসাপত্রগুলি কনফিগার হয়ে গেলে, আপনি রপ্তানি করা ক্যাসান্দ্রা স্কিমা ফাইল থেকে স্প্যানার স্কিমা তৈরি করতে স্প্যানার ক্যাসান্দ্রা স্কিমা টুল চালানোর জন্য প্রস্তুত৷ আপনার টার্মিনাল বা ক্লাউড শেলের spanner-cassandra-schema-tool ডিরেক্টরিতে নেভিগেট করুন এবং নিম্নলিখিত go run কমান্ডটি চালান:

go run schema_converter.go \
    --project $PROJECT_ID \
    --instance $SPANNER_INSTANCE_ID \
    --database $SPANNER_DATABASE \
    --cql orig_schema.cql \
    --dry-run

--dry-run বিকল্পের সাথে চলমান স্কিমা তৈরি করে। টুল দ্বারা উত্পন্ন ডেটা টাইপ ম্যাপিং এবং প্রাথমিক কী কলামগুলি পর্যালোচনা এবং পরিমার্জন করুন। নিশ্চিত করুন যে স্প্যানার ডেটা টাইপগুলি সংশ্লিষ্ট ক্যাসান্ড্রা ডাটাবেসের প্রকারের পরিসীমা, নির্ভুলতা এবং শব্দার্থকে সঠিকভাবে উপস্থাপন করে।

এই টুলটি ক্যাসান্দ্রা প্রকারগুলিকে স্প্যানার প্রকারগুলিকে মানচিত্র করে যেমন সমর্থিত ক্যাসান্দ্রা ডেটা প্রকারগুলিতে নথিভুক্ত করা হয়েছে৷

কমান্ড আউটপুট এই মত কিছু দেখতে হবে:

.....

[Converted Spanner statement]
CREATE TABLE users (
 id INT64 NOT NULL OPTIONS (cassandra_type = 'int'),
 active BOOL OPTIONS (cassandra_type = 'boolean'),
 username STRING(MAX) OPTIONS (cassandra_type = 'text'),
) PRIMARY KEY (id)
----------------------------------------------
Writing converted Spanner schema to: schema.txt
Dry run enabled. Skipping schema execution.
Schema conversion completed!

যদি আপনি স্পেনারে প্রয়োগের স্কিমা স্বয়ংক্রিয়ভাবে প্রয়োগ করতে চান তবে আপনার --dry-run বিকল্প ছাড়াই cli চালানো উচিত।

Google ক্লাউড কনসোলে যাচাই করুন যে টেবিল এবং মেটাডেটা টেবিল ক্লাউড স্প্যানার ডাটাবেসে বিদ্যমান।

6. ইনকামিং ডেটার জন্য ডুয়াল রাইট সেট আপ করুন

[টুডো]

7. আপনার ঐতিহাসিক ডেটা বাল্ক এক্সপোর্ট করুন

[টুডো]

8. আপনার ডেটা যাচাই করুন

[টুডো]

9. আপনার আবেদনটি স্প্যানারে নির্দেশ করুন (কাটওভার)

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

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

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

জাভা অ্যাপ্লিকেশনগুলির জন্য ইতিমধ্যেই cassandra-java-driver লাইব্রেরি ব্যবহার করছে, স্প্যানার ক্যাসান্দ্রা জাভা ক্লায়েন্টকে একীভূত করার জন্য CqlSession প্রারম্ভিকতায় শুধুমাত্র ছোটখাটো পরিবর্তন প্রয়োজন।

গুগল-ক্লাউড-স্প্যানার-ক্যাসান্ড্রা নির্ভরতা পাওয়া

স্প্যানার ক্যাসান্দ্রা ক্লায়েন্ট ব্যবহার শুরু করতে, আপনাকে প্রথমে আপনার প্রকল্পে এর নির্ভরতা অন্তর্ভুক্ত করতে হবে। google-cloud-spanner-cassandra artifacts com.google.cloud গ্রুপ আইডির অধীনে মাভেন সেন্ট্রালে প্রকাশিত হয়েছে। আপনার জাভা প্রকল্পে বিদ্যমান <dependencies> বিভাগের অধীনে নিম্নলিখিত নতুন নির্ভরতা যোগ করুন। আপনি কীভাবে google-cloud-spanner-cassandra নির্ভরতা অন্তর্ভুক্ত করবেন তার একটি সরলীকৃত উদাহরণ এখানে দেওয়া হল:

<!-- native Spanner Cassandra Client -->
<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-spanner-cassandra</artifactId>
    <version>0.2.0</version>
  </dependency>
</dependencies>

স্প্যানারে সংযোগ করতে সংযোগ কনফিগারেশন পরিবর্তন করুন

একবার আপনি প্রয়োজনীয় নির্ভরতা যোগ করলে, পরবর্তী ধাপ হল স্প্যানার ডাটাবেসের সাথে সংযোগ করতে আপনার সংযোগ কনফিগারেশন পরিবর্তন করা।

ক্যাসান্ড্রা ক্লাস্টারের সাথে ইন্টারঅ্যাক্ট করা একটি সাধারণ অ্যাপ্লিকেশন প্রায়শই একটি সংযোগ স্থাপন করতে নিম্নলিখিতগুলির মতো কোড ব্যবহার করে:

CqlSession session = CqlSession.builder()
        .addContactPoint(new InetSocketAddress("127.0.0.1", 9042))
        .withLocalDatacenter("datacenter1")
        .withAuthCredentials("username", "password")
        .build();

এই সংযোগটি স্প্যানারে পুনঃনির্দেশিত করতে, আপনাকে আপনার CqlSession সৃষ্টির যুক্তি পরিবর্তন করতে হবে। cassandra-java-driver থেকে সরাসরি স্ট্যান্ডার্ড CqlSessionBuilder ব্যবহার করার পরিবর্তে, আপনি Spanner Cassandra ক্লায়েন্ট দ্বারা প্রদত্ত SpannerCqlSession.builder() ব্যবহার করবেন। আপনার সংযোগ কোডটি কীভাবে পরিবর্তন করবেন তার একটি উদাহরণমূলক উদাহরণ এখানে দেওয়া হল:

String databaseUri = "projects/<your-gcp-project>/instances/<your-spanner-instance>/databases/<your-spanner-database>";

CqlSession session = SpannerCqlSession.builder()
        .setDatabaseUri(databaseUri)
        .addContactPoint(new InetSocketAddress("localhost", 9042))
        .withLocalDatacenter("datacenter1")
        .build();

দ্রষ্টব্য: databaseUri হল একটি গুরুত্বপূর্ণ প্যারামিটার যা আপনার টার্গেট স্প্যানার ডাটাবেসের সঠিক অবস্থান নির্দিষ্ট করে। এটি ফর্ম্যাট অনুসরণ করে: projects/<your-gcp-project>/instances/your-spanner-instance>/databases/<your-spanner-database> । নিশ্চিত করুন যে আপনি আপনার প্রকৃত Google ক্লাউড প্রকল্প আইডি, স্প্যানার ইনস্ট্যান্স নাম এবং স্প্যানার ডাটাবেসের নাম দিয়ে স্থানধারকগুলি প্রতিস্থাপন করেছেন৷

SpannerCqlSession.builder() ব্যবহার করে CqlSession চালু করে এবং সঠিক databaseUri প্রদান করে, আপনার অ্যাপ্লিকেশনটি এখন আপনার লক্ষ্য স্প্যানার ডাটাবেসের সাথে স্প্যানার ক্যাসান্দ্রা ক্লায়েন্টের মাধ্যমে একটি সংযোগ স্থাপন করবে। এই গুরুত্বপূর্ণ পরিবর্তনটি নিশ্চিত করে যে আপনার অ্যাপ্লিকেশন দ্বারা সম্পাদিত পরবর্তী সমস্ত পঠন এবং লেখার ক্রিয়াকলাপগুলি স্প্যানার দ্বারা পরিচালিত হবে এবং পরিবেশন করা হবে, কার্যকরভাবে প্রাথমিক কাটওভারটি সম্পূর্ণ করবে। এই মুহুর্তে, আপনার অ্যাপ্লিকেশনটি প্রত্যাশিত হিসাবে কাজ করা চালিয়ে যাওয়া উচিত, এখন স্প্যানারের মাপযোগ্যতা এবং নির্ভরযোগ্যতা দ্বারা চালিত।

আন্ডার দ্য হুড: কিভাবে স্প্যানার ক্যাসান্দ্রা ক্লায়েন্ট কাজ করে

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

একবার আপনি নিশ্চিত হন যে স্প্যানার সমস্ত ট্রাফিক সঠিকভাবে পরিবেশন করছে, আপনি শেষ পর্যন্ত:

• দ্বৈত লেখা বন্ধ করুন।
• মূল ক্যাসান্দ্রা ক্লাস্টার বাতিল করুন।

10. পরিষ্কার করা (ঐচ্ছিক)

পরিষ্কার করতে, কেবল ক্লাউড কনসোলের স্প্যানার বিভাগে যান এবং কোডল্যাবে আমরা তৈরি করা cassandra-adapter-demo উদাহরণটি মুছুন।

ক্যাসান্ড্রা ডাটাবেস মুছুন (যদি স্থানীয়ভাবে ইনস্টল করা থাকে বা অব্যাহত থাকে)

আপনি যদি এখানে তৈরি করা কম্পিউট ইঞ্জিন VM-এর বাইরে Cassandra ইনস্টল করেন, তাহলে ডেটা সরাতে বা Cassandra আনইনস্টল করার জন্য উপযুক্ত পদক্ষেপগুলি অনুসরণ করুন।

11. অভিনন্দন!

এরপর কি?

• ক্লাউড স্প্যানার সম্পর্কে আরও জানুন।
• ক্যাসান্দ্রা ইন্টারফেস সম্পর্কে আরও জানুন।