ক্লাউড স্প্যানার: জাভা দিয়ে একটি গেমিং লিডারবোর্ড তৈরি করুন

1. সংক্ষিপ্ত বিবরণ

গুগল ক্লাউড স্প্যানার একটি সম্পূর্ণরূপে পরিচালিত অনুভূমিকভাবে স্কেলেবল, বিশ্বব্যাপী বিতরণযোগ্য, রিলেশনাল ডাটাবেস পরিষেবা যা কর্মক্ষমতা এবং উচ্চ প্রাপ্যতা ত্যাগ না করেই ACID লেনদেন এবং SQL শব্দার্থবিদ্যা প্রদান করে।

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

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

তুমি কি শিখবে

  • কিভাবে একটি ক্লাউড স্প্যানার ইনস্ট্যান্স সেটআপ করবেন।
  • কিভাবে একটি ডাটাবেস এবং টেবিল তৈরি করবেন।
  • কমিট টাইমস্ট্যাম্প কলাম কীভাবে ব্যবহার করবেন।
  • টাইমস্ট্যাম্প ব্যবহার করে আপনার ক্লাউড স্প্যানার ডাটাবেস টেবিলে ডেটা কীভাবে লোড করবেন।
  • আপনার ক্লাউড স্প্যানার ডাটাবেস কীভাবে জিজ্ঞাসা করবেন।
  • আপনার ক্লাউড স্প্যানার ইনস্ট্যান্সটি কীভাবে মুছে ফেলবেন।

তোমার যা লাগবে

আপনি এই টিউটোরিয়ালটি কীভাবে ব্যবহার করবেন?

শুধু পুরোটা পড়ুন এটি পড়ুন এবং অনুশীলনগুলি সম্পূর্ণ করুন।

গুগল ক্লাউড প্ল্যাটফর্মের সাথে আপনার অভিজ্ঞতাকে কীভাবে মূল্যায়ন করবেন?

নবীন মধ্যবর্তী দক্ষ

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

স্ব-গতিসম্পন্ন পরিবেশ সেটআপ

যদি আপনার ইতিমধ্যেই একটি Google অ্যাকাউন্ট (Gmail বা Google Apps) না থাকে, তাহলে আপনাকে অবশ্যই একটি তৈরি করতে হবে। Google Cloud Platform কনসোলে ( console.cloud.google.com ) সাইন-ইন করুন এবং একটি নতুন প্রকল্প তৈরি করুন।

যদি আপনার ইতিমধ্যেই একটি প্রকল্প থাকে, তাহলে কনসোলের উপরের বাম দিকে প্রকল্প নির্বাচন পুল ডাউন মেনুতে ক্লিক করুন:

6c9406d9b014760.png সম্পর্কে

এবং একটি নতুন প্রকল্প তৈরি করতে ফলাফলের ডায়ালগে 'নতুন প্রকল্প' বোতামে ক্লিক করুন:

f708315ae07353d0.png

যদি আপনার ইতিমধ্যেই কোন প্রকল্প না থাকে, তাহলে আপনার প্রথমটি তৈরি করার জন্য আপনার এইরকম একটি ডায়ালগ দেখতে হবে:

870a3cbd6541ee86.png সম্পর্কে

পরবর্তী প্রকল্প তৈরির ডায়ালগ আপনাকে আপনার নতুন প্রকল্পের বিশদ বিবরণ প্রবেশ করতে দেয়:

6a92c57d3250a4b3.png সম্পর্কে

প্রজেক্ট আইডিটি মনে রাখবেন, যা সমস্ত গুগল ক্লাউড প্রোজেক্টের জন্য একটি অনন্য নাম (উপরের নামটি ইতিমধ্যেই নেওয়া হয়েছে এবং আপনার জন্য কাজ করবে না, দুঃখিত!)। এই কোডল্যাবে পরে এটিকে PROJECT_ID হিসাবে উল্লেখ করা হবে।

এরপর, যদি আপনি ইতিমধ্যেই এটি না করে থাকেন, তাহলে Google ক্লাউড রিসোর্স ব্যবহার করতে এবং Cloud Spanner API সক্ষম করতে আপনাকে Developers Console-এ বিলিং সক্ষম করতে হবে।

15d0ef27a8fbab27.png সম্পর্কে

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

গুগল ক্লাউড প্ল্যাটফর্মের নতুন ব্যবহারকারীরা $300 এর বিনামূল্যে ট্রায়ালের জন্য যোগ্য, যার ফলে এই কোডল্যাবটি সম্পূর্ণ বিনামূল্যে হবে।

গুগল ক্লাউড শেল সেটআপ

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

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

  1. ক্লাউড কনসোল থেকে ক্লাউড শেল সক্রিয় করতে, কেবল ক্লাউড শেল সক্রিয় করুন ক্লিক করুন gcLMt5IuEcJJNnMId-Bcz3sxCd0rZn7IzT_r95C8UZeqML68Y1efBG_B0VRp7hc7qiZTLAF-TXD7SsOadxn8uadgHhaLeASnVS3ZHK39eOlKJOgj9SJua_oeGhMxRrbOg3qigddS2A (পরিবেশের সাথে সংযোগ স্থাপন এবং সংযোগ স্থাপন করতে মাত্র কয়েক মুহূর্ত সময় লাগবে)।

JjEuRXGg0AYYIY6QZ8d-66gx_Mtc-_jDE9ijmbXLJSAXFvJt-qUpNtsBsYjNpv2W6BQSr Dc1D-ARINNQ-1EkwUhz-iUK-FUCZhJ-NtjvIEx9pIkE-246DomWuCfiGHK78DgoeWkHRw

স্ক্রিন শট ২০১৭-০৬-১৪ রাত ১০.১৩.৪৩.png

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

gcloud auth list

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

Credentialed accounts:
 - <myaccount>@<mydomain>.com (active)
gcloud config list project

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

[core]
project = <PROJECT_ID>

যদি, কোনও কারণে, প্রকল্পটি সেট না করা থাকে, তাহলে কেবল নিম্নলিখিত কমান্ডটি জারি করুন:

gcloud config set project <PROJECT_ID>

আপনার PROJECT_ID খুঁজছেন? সেটআপ ধাপে আপনি কোন আইডি ব্যবহার করেছেন তা দেখুন অথবা ক্লাউড কনসোল ড্যাশবোর্ডে এটি দেখুন:

158fNPfwSxsFqz9YbtJVZes8viTS3d1bV4CVhij3XPxuzVFOtTObnwsphlm6lYGmgdMFwBJtc-FaLrZU7XHAg_ZYoCrgombMRR3h-eolLPcvO351c5iBv506B3ZwghZoiRg6cz23Qw

ক্লাউড শেল ডিফল্টরূপে কিছু পরিবেশ ভেরিয়েবল সেট করে, যা ভবিষ্যতের কমান্ড চালানোর সময় কার্যকর হতে পারে।

echo $GOOGLE_CLOUD_PROJECT

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

<PROJECT_ID>
  1. অবশেষে, ডিফল্ট জোন এবং প্রকল্প কনফিগারেশন সেট করুন।
gcloud config set compute/zone us-central1-f

আপনি বিভিন্ন ধরণের অঞ্চল বেছে নিতে পারেন। আরও তথ্যের জন্য, অঞ্চল এবং অঞ্চল দেখুন।

সারাংশ

এই ধাপে, আপনি আপনার পরিবেশ সেটআপ করুন।

পরবর্তী

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

৩. একটি ক্লাউড স্প্যানার ইন্সট্যান্স সেটআপ করুন

এই ধাপে আমরা এই কোডল্যাবের জন্য আমাদের ক্লাউড স্প্যানার ইন্সট্যান্স সেটআপ করব। স্প্যানার এন্ট্রিটি অনুসন্ধান করুন। 1a6580bd3d3e6783.png সম্পর্কে বাম দিকের উপরের হ্যামবার্গার মেনুতে 3129589f7bc9e5ce.png সম্পর্কে অথবা "/" টিপে "Spanner" টাইপ করে Spanner অনুসন্ধান করুন।

36e52f8df8e13b99.png সম্পর্কে

এরপর, ক্লিক করুন 95269e75bc8c3e4d.png সম্পর্কে এবং আপনার ইনস্ট্যান্সের জন্য cloudspanner-leaderboard নামটি প্রবেশ করিয়ে ফর্মটি পূরণ করুন, একটি কনফিগারেশন নির্বাচন করুন (একটি আঞ্চলিক ইনস্ট্যান্স নির্বাচন করুন), এবং নোডের সংখ্যা সেট করুন, এই কোডল্যাবের জন্য আমাদের কেবল 1টি নোডের প্রয়োজন হবে। উৎপাদন ইনস্ট্যান্সের জন্য এবং ক্লাউড স্প্যানার SLA-এর জন্য যোগ্যতা অর্জনের জন্য আপনাকে আপনার ক্লাউড স্প্যানার ইনস্ট্যান্সে 3 বা তার বেশি নোড চালাতে হবে।

সবশেষে, কিন্তু সর্বনিম্ন নয়, "তৈরি করুন" এ ক্লিক করুন এবং কয়েক সেকেন্ডের মধ্যেই আপনার হাতে একটি ক্লাউড স্প্যানার ইনস্ট্যান্স থাকবে।

dceb68e9ed3801e8.png সম্পর্কে

পরবর্তী ধাপে আমরা জাভা ক্লায়েন্ট লাইব্রেরি ব্যবহার করে আমাদের নতুন ইনস্ট্যান্সে একটি ডাটাবেস এবং স্কিমা তৈরি করব।

৪. একটি ডাটাবেস এবং স্কিমা তৈরি করুন

এই ধাপে আমরা আমাদের নমুনা ডাটাবেস এবং স্কিমা তৈরি করব।

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

প্রথমে ক্লাউড শেলে নিম্নলিখিত কমান্ডটি টাইপ করে Github থেকে এই কোডল্যাবের নমুনা কোডটি ক্লোন করুন:

git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git

তারপর ডিরেক্টরিটি "অ্যাপ্লিকেশন" ডিরেক্টরিতে পরিবর্তন করুন যেখানে আপনি আপনার অ্যাপ্লিকেশন তৈরি করবেন।

cd java-docs-samples/spanner/leaderboard

এই কোডল্যাবের জন্য প্রয়োজনীয় সমস্ত কোড বিদ্যমান java-docs-samples/spanner/leaderboard/complete ডিরেক্টরিতে Leaderboard নামে একটি রানযোগ্য C# অ্যাপ্লিকেশন হিসেবে অবস্থিত যা কোডল্যাবের মধ্য দিয়ে এগিয়ে যাওয়ার সাথে সাথে রেফারেন্স হিসেবে কাজ করবে। আমরা একটি নতুন ডিরেক্টরি তৈরি করব এবং পর্যায়ক্রমে লিডারবোর্ড অ্যাপ্লিকেশনের একটি অনুলিপি তৈরি করব।

অ্যাপ্লিকেশনটির জন্য "codelab" নামে একটি নতুন ডিরেক্টরি তৈরি করুন এবং নিম্নলিখিত কমান্ডটি ব্যবহার করে ডিরেক্টরিটি এতে পরিবর্তন করুন:

mkdir codelab && cd $_

নিম্নলিখিত Maven (mvn) কমান্ড ব্যবহার করে "Leaderboard" নামে একটি নতুন মৌলিক জাভা অ্যাপ্লিকেশন তৈরি করুন:

mvn -B archetype:generate -DarchetypeGroupId=org.apache.maven.archetypes -DgroupId=com.google.codelabs -DartifactId=leaderboard -DarchetypeVersion=1.4

এই কমান্ডটি একটি সহজ কনসোল অ্যাপ্লিকেশন তৈরি করে যার মধ্যে দুটি প্রাথমিক ফাইল, Maven অ্যাপ কনফিগারেশন ফাইল pom.xml এবং জাভা অ্যাপ ফাইল App.java থাকে।

এরপর, ডিরেক্টরিটিকে লিডারবোর্ড ডিরেক্টরিতে পরিবর্তন করুন যা সবেমাত্র তৈরি করা হয়েছে এবং এর বিষয়বস্তু তালিকাভুক্ত করুন:

cd leaderboard && ls

আপনি pom.xml ফাইল এবং src ডিরেক্টরি তালিকাভুক্ত দেখতে পাবেন:

pom.xml  src

এবার আসুন এই কনসোল অ্যাপটি আপডেট করি App.java এডিট করে, যাতে জাভা স্প্যানার ক্লায়েন্ট লাইব্রেরি ব্যবহার করে দুটি টেবিলের একটি লিডারবোর্ড তৈরি করা যায়; প্লেয়ার এবং স্কোর। আপনি এটি সরাসরি ক্লাউড শেল এডিটরে করতে পারেন:

নিচে হাইলাইট করা আইকনে ক্লিক করে ক্লাউড শেল এডিটর খুলুন:

73cf70e05f653ca.png সম্পর্কে

লিডারবোর্ড ফোল্ডারের নিচে pom.xml খুলুন। java-docs-samples\ spanner\leaderboard\codelab\leaderboard ফোল্ডারে থাকা pom.xml ফাইলটি খুলুন। এই ফাইলটি আমাদের অ্যাপ্লিকেশনটিকে একটি জারে তৈরি করার জন্য maven বিল্ড সিস্টেমকে কনফিগার করে, যার মধ্যে আমাদের সমস্ত নির্ভরতা অন্তর্ভুক্ত থাকে।

বিদ্যমান </properties> উপাদানের ঠিক নীচে নিম্নলিখিত 1টি নতুন নির্ভরতা ব্যবস্থাপনা বিভাগ যুক্ত করুন:

<dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>com.google.cloud</groupId>
        <artifactId>google-cloud-bom</artifactId>
        <version>0.83.0-alpha</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>

এছাড়াও বিদ্যমান <dependencies> বিভাগে 1টি নতুন নির্ভরতা যোগ করুন, যা অ্যাপ্লিকেশনটিতে ক্লাউড স্প্যানার জাভা ক্লায়েন্ট লাইব্রেরি যুক্ত করবে।

    <dependency>
      <!-- Version auto-managed by BOM -->
      <groupId>com.google.cloud</groupId>
      <artifactId>google-cloud-spanner</artifactId>
    </dependency>  

তারপর pom.xml ফাইলের বিদ্যমান <build> অংশটি নিম্নলিখিত <build> অংশ দিয়ে প্রতিস্থাপন করুন:

 <build>
    <plugins>
      <plugin>
        <artifactId>maven-assembly-plugin</artifactId>
        <version>2.5.5</version>
        <configuration>
          <finalName>leaderboard</finalName>
          <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
          </descriptorRefs>
          <archive>
            <manifest>
              <mainClass>com.google.codelabs.App</mainClass>
            </manifest>
          </archive>
          <appendAssemblyId>false</appendAssemblyId>
          <attach>false</attach>
        </configuration>
        <executions>
          <execution>
            <id>make-assembly</id>
            <phase>package</phase>
            <goals>
              <goal>single</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-failsafe-plugin</artifactId>
        <version>3.0.0-M3</version>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-surefire-plugin</artifactId>
        <version>3.0.0-M3</version>
        <configuration>
            <useSystemClassLoader>false</useSystemClassLoader>
        </configuration>
      </plugin>  
    </plugins>
  </build>

pom.xml ফাইলে করা পরিবর্তনগুলি Cloud Shell Editor-এর "File" মেনুর অধীনে "Save" নির্বাচন করে অথবা "Ctrl" এবং "S" কীবোর্ড কী একসাথে টিপে সংরক্ষণ করুন।

এরপর, src/main/java/com/google/codelabs/ ফোল্ডারে অবস্থিত Cloud Shell Editor-এ App.java ফাইলটি খুলুন। নিম্নলিখিত জাভা কোডটি App.java ফাইলে পেস্ট করে leaderboard ডাটাবেস এবং Players এবং Scores টেবিল তৈরি করার জন্য প্রয়োজনীয় কোড দিয়ে ফাইলের বিদ্যমান কোডটি প্রতিস্থাপন করুন:

package com.google.codelabs;

import com.google.api.gax.longrunning.OperationFuture;
import com.google.cloud.spanner.Database;
import com.google.cloud.spanner.DatabaseAdminClient;
import com.google.cloud.spanner.DatabaseClient;
import com.google.cloud.spanner.DatabaseId;
import com.google.cloud.spanner.Spanner;
import com.google.cloud.spanner.SpannerException;
import com.google.cloud.spanner.SpannerExceptionFactory;
import com.google.cloud.spanner.SpannerOptions;
import com.google.spanner.admin.database.v1.CreateDatabaseMetadata;
import java.util.Arrays;
import java.util.concurrent.ExecutionException;

/**
 * Example code for using the Cloud Spanner API with the Google Cloud Java client library
 * to create a simple leaderboard.
 * 
 * This example demonstrates:
 *
 * <p>
 *
 * <ul>
 *   <li>Creating a Cloud Spanner database.
 * </ul>
 */
public class App {

  static void create(DatabaseAdminClient dbAdminClient, DatabaseId db) {
    OperationFuture<Database, CreateDatabaseMetadata> op =
        dbAdminClient.createDatabase(
            db.getInstanceId().getInstance(),
            db.getDatabase(),
            Arrays.asList(
                "CREATE TABLE Players(\n"
                    + "  PlayerId INT64 NOT NULL,\n"
                    + "  PlayerName STRING(2048) NOT NULL\n"
                    + ") PRIMARY KEY(PlayerId)",
                "CREATE TABLE Scores(\n"
                    + "  PlayerId INT64 NOT NULL,\n"
                    + "  Score INT64 NOT NULL,\n"
                    + "  Timestamp TIMESTAMP NOT NULL\n"
                    + "  OPTIONS(allow_commit_timestamp=true)\n"
                    + ") PRIMARY KEY(PlayerId, Timestamp),\n"
                    + "INTERLEAVE IN PARENT Players ON DELETE NO ACTION"));
    try {
      // Initiate the request which returns an OperationFuture.
      Database dbOperation = op.get();
      System.out.println("Created database [" + dbOperation.getId() + "]");
    } catch (ExecutionException e) {
      // If the operation failed during execution, expose the cause.
      throw (SpannerException) e.getCause();
    } catch (InterruptedException e) {
      // Throw when a thread is waiting, sleeping, or otherwise occupied,
      // and the thread is interrupted, either before or during the activity.
      throw SpannerExceptionFactory.propagateInterrupt(e);
    }
  }

  static void printUsageAndExit() {
    System.out.println("Leaderboard 1.0.0");
    System.out.println("Usage:");
    System.out.println("  java -jar leaderboard.jar "
        + "<command> <instance_id> <database_id> [command_option]");
    System.out.println("");
    System.out.println("Examples:");
    System.out.println("  java -jar leaderboard.jar create my-instance example-db");
    System.out.println("      - Create a sample Cloud Spanner database along with "
        + "sample tables in your project.\n");
    System.exit(1);
  }

  public static void main(String[] args) throws Exception {
    if (!(args.length == 3 || args.length == 4)) {
      printUsageAndExit();
    }
    SpannerOptions options = SpannerOptions.newBuilder().build();
    Spanner spanner = options.getService();
    try {
      String command = args[0];
      DatabaseId db = DatabaseId.of(options.getProjectId(), args[1], args[2]);
      DatabaseClient dbClient = spanner.getDatabaseClient(db);
      DatabaseAdminClient dbAdminClient = spanner.getDatabaseAdminClient();
      switch (command) {
        case "create":
          create(dbAdminClient, db);
          break;
        default:
          printUsageAndExit();
      }
    } finally {
      spanner.close();
    }
    System.out.println("Closed client");
  }
}

ক্লাউড শেল এডিটরের "ফাইল" মেনুর অধীনে "সংরক্ষণ করুন" নির্বাচন করে App.java ফাইলে আপনার করা পরিবর্তনগুলি সংরক্ষণ করুন।

কোড যোগ করার পর আপনার App.java ফাইলটি কেমন দেখাবে তার একটি উদাহরণ দেখতে আপনি java-docs-samples/spanner/leaderboard/step4/src ডিরেক্টরিতে App.java ফাইলটি ব্যবহার করতে পারেন। create কমান্ড সক্রিয় করার জন্য কোডটি যোগ করার পরে আপনার App.java ফাইলটি কেমন দেখাবে তার একটি উদাহরণ দেখতে পারেন।

আপনার অ্যাপ তৈরি করতে, আপনার pom.xml যে ডিরেক্টরিতে অবস্থিত সেখান থেকে mvn প্যাকেজ চালান:

mvn package

আপনার জাভা জার ফাইলটি সফলভাবে তৈরি হয়ে গেলে, নিম্নলিখিত কমান্ডটি প্রবেশ করে ক্লাউড শেলে ফলাফল অ্যাপ্লিকেশনটি চালান:

java -jar target/leaderboard.jar

আপনি নিম্নলিখিত মত আউটপুট দেখতে পাবেন:

Leaderboard 1.0.0
Usage:
  java -jar leaderboard.jar <command> <instance_id> <database_id> [command_option]

Examples:
  java -jar leaderboard.jar create my-instance example-db
      - Create a sample Cloud Spanner database along with sample tables in your project.

এই উত্তর থেকে আমরা দেখতে পাচ্ছি যে এটি Leaderboard অ্যাপ্লিকেশন যার বর্তমানে একটি সম্ভাব্য কমান্ড রয়েছে: create । আমরা দেখতে পাচ্ছি যে create কমান্ডের প্রত্যাশিত আর্গুমেন্টগুলি হল Instance ID এবং Database ID।

এবার নিচের কমান্ডটি চালান।

java -jar target/leaderboard.jar create cloudspanner-leaderboard leaderboard

কয়েক সেকেন্ড পরে আপনি নিচের মত একটি প্রতিক্রিয়া দেখতে পাবেন:

Created database [projects/your-project/instances/cloudspanner-leaderboard/databases/leaderboard] 

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

ba9008bb84cb90b0.png সম্পর্কে

পরবর্তী ধাপে আমরা আপনার নতুন ডাটাবেসে কিছু ডেটা লোড করার জন্য আমাদের অ্যাপ্লিকেশনটি আপডেট করব।

৫. ডেটা লোড করুন

এখন আমাদের কাছে leaderboard নামে একটি ডাটাবেস আছে যেখানে দুটি টেবিল রয়েছে; Players এবং Scores । এবার আসুন জাভা ক্লায়েন্ট লাইব্রেরি ব্যবহার করে আমাদের Players টেবিলে খেলোয়াড় এবং আমাদের Scores টেবিলে প্রতিটি খেলোয়াড়ের জন্য র‍্যান্ডম স্কোর তৈরি করি।

যদি এটি ইতিমধ্যে খোলা না থাকে, তাহলে নীচে হাইলাইট করা আইকনে ক্লিক করে ক্লাউড শেল এডিটরটি খুলুন:

অনুসরণ

এরপর, ক্লাউড শেল এডিটরে App.java ফাইলটি সম্পাদনা করে একটি insert কমান্ড যোগ করুন যা Players টেবিলে 100 জন খেলোয়াড় সন্নিবেশ করতে ব্যবহার করা যেতে পারে অথবা Players টেবিলের প্রতিটি খেলোয়াড়ের জন্য Scores টেবিলে 4টি র্যান্ডম স্কোর সন্নিবেশ করতে ব্যবহার করা যেতে পারে।

প্রথমে অ্যাপ ফাইলের উপরে থাকা imports বিভাগটি আপডেট করুন, বর্তমানে যা আছে তা প্রতিস্থাপন করুন যাতে আপনার কাজ শেষ হয়ে গেলে এটি নিম্নলিখিতটির মতো দেখায়:

package com.google.codelabs;

import static com.google.cloud.spanner.TransactionRunner.TransactionCallable;

import com.google.api.gax.longrunning.OperationFuture;
import com.google.cloud.spanner.Database;
import com.google.cloud.spanner.DatabaseAdminClient;
import com.google.cloud.spanner.DatabaseClient;
import com.google.cloud.spanner.DatabaseId;
import com.google.cloud.spanner.Mutation;
import com.google.cloud.spanner.ResultSet;
import com.google.cloud.spanner.Spanner;
import com.google.cloud.spanner.SpannerException;
import com.google.cloud.spanner.SpannerExceptionFactory;
import com.google.cloud.spanner.SpannerOptions;
import com.google.cloud.spanner.Statement;
import com.google.cloud.spanner.TransactionContext;
import com.google.spanner.admin.database.v1.CreateDatabaseMetadata;
import java.time.Instant;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.ZoneOffset;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
import java.util.Random;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.ThreadLocalRandom;

এরপর বিদ্যমান create() পদ্ধতির নিচে এবং বিদ্যমান printUsageAndExit() পদ্ধতির উপরে নিম্নলিখিত insert, insertPlayers এবং insertScores পদ্ধতিগুলি যোগ করুন:

  static void insert(DatabaseClient dbClient, String insertType) {
    try {
      insertType = insertType.toLowerCase();
    } catch (Exception e) {
      // Invalid input received, set insertType to empty string.
      insertType = "";
    }
    if (insertType.equals("players")) {
      // Insert players.
      insertPlayers(dbClient);
    } else if (insertType.equals("scores")) {
      // Insert scores.
      insertScores(dbClient);
    } else {
      // Invalid input.
      System.out.println("Invalid value for 'type of insert'. "
          + "Specify a valid value: 'players' or 'scores'.");
      System.exit(1);
    }
  }

  static void insertPlayers(DatabaseClient dbClient) {
    dbClient
        .readWriteTransaction()
        .run(
            new TransactionCallable<Void>() {
              @Override
              public Void run(TransactionContext transaction) throws Exception {
                // Get the number of players.
                String sql = "SELECT Count(PlayerId) as PlayerCount FROM Players";
                ResultSet resultSet = transaction.executeQuery(Statement.of(sql));
                long numberOfPlayers = 0;
                if (resultSet.next()) {
                  numberOfPlayers = resultSet.getLong("PlayerCount");
                }
                // Insert 100 player records into the Players table.
                List<Statement> stmts = new ArrayList<Statement>();
                long randomId;
                for (int x = 1; x <= 100; x++) {
                  numberOfPlayers++;
                  randomId = (long) Math.floor(Math.random() * 9_000_000_000L) + 1_000_000_000L;
                  Statement statement =
                      Statement
                        .newBuilder(
                            "INSERT INTO Players (PlayerId, PlayerName) "
                            + "VALUES (@PlayerId, @PlayerName) ")
                        .bind("PlayerId")
                        .to(randomId)
                        .bind("PlayerName")
                        .to("Player " + numberOfPlayers)
                        .build();
                  stmts.add(statement);
                }
                transaction.batchUpdate(stmts);
                return null;
              }
            });
    System.out.println("Done inserting player records...");
  }

  static void insertScores(DatabaseClient dbClient) {
    boolean playerRecordsFound = false;
    ResultSet resultSet =
        dbClient
            .singleUse()
            .executeQuery(Statement.of("SELECT * FROM Players"));
    while (resultSet.next()) {
      playerRecordsFound = true;
      final long playerId = resultSet.getLong("PlayerId");
      dbClient
          .readWriteTransaction()
          .run(
              new TransactionCallable<Void>() {
                @Override
                public Void run(TransactionContext transaction) throws Exception {
                  // Initialize objects for random Score and random Timestamp.
                  LocalDate endDate = LocalDate.now();
                  long end = endDate.toEpochDay();
                  int startYear = endDate.getYear() - 2;
                  int startMonth = endDate.getMonthValue();
                  int startDay = endDate.getDayOfMonth();
                  LocalDate startDate = LocalDate.of(startYear, startMonth, startDay);
                  long start = startDate.toEpochDay();
                  Random r = new Random();
                  List<Statement> stmts = new ArrayList<Statement>();
                  // Insert 4 score records into the Scores table 
                  // for each player in the Players table.
                  for (int x = 1; x <= 4; x++) {
                    // Generate random score between 1,000,000 and 1,000
                    long randomScore = r.nextInt(1000000 - 1000) + 1000;
                    // Get random day within the past two years.
                    long randomDay = ThreadLocalRandom.current().nextLong(start, end);
                    LocalDate randomDayDate = LocalDate.ofEpochDay(randomDay);
                    LocalTime randomTime = LocalTime.of(
                        r.nextInt(23), r.nextInt(59), r.nextInt(59), r.nextInt(9999));
                    LocalDateTime randomDate = LocalDateTime.of(randomDayDate, randomTime);
                    Instant randomInstant = randomDate.toInstant(ZoneOffset.UTC);
                    Statement statement =
                        Statement
                        .newBuilder(
                          "INSERT INTO Scores (PlayerId, Score, Timestamp) "
                          + "VALUES (@PlayerId, @Score, @Timestamp) ")
                        .bind("PlayerId")
                        .to(playerId)
                        .bind("Score")
                        .to(randomScore)
                        .bind("Timestamp")
                        .to(randomInstant.toString())
                        .build();
                    stmts.add(statement);
                  }
                  transaction.batchUpdate(stmts);
                  return null;
                }
              });

    }
    if (!playerRecordsFound) {
      System.out.println("Parameter 'scores' is invalid since "
          + "no player records currently exist. First insert players "
          + "then insert scores.");
      System.exit(1);
    } else {
      System.out.println("Done inserting score records...");
    }
  }

তারপর, insert কমান্ডটি কার্যকরী করতে, switch (command) স্টেটমেন্টের মধ্যে আপনার অ্যাপের "main" পদ্ধতিতে নিম্নলিখিত কোডটি যোগ করুন:

        case "insert":
          String insertType;
          try {
            insertType = args[3];
          } catch (ArrayIndexOutOfBoundsException exception) {
            insertType = "";
          }
          insert(dbClient, insertType);
          break;

একবার কাজ শেষ হয়ে গেলে switch (command) স্টেটমেন্টটি নিচের মতো দেখাবে:

      switch (command) {
        case "create":
          create(dbAdminClient, db);
          break;
        case "insert":
          String insertType;
          try {
            insertType = args[3];
          } catch (ArrayIndexOutOfBoundsException exception) {
            insertType = "";
          }
          insert(dbClient, insertType);
          break;
        default:
          printUsageAndExit();
      }

আপনার অ্যাপে "insert" কার্যকারিতা যোগ করার শেষ ধাপ হল printUsageAndExit() পদ্ধতিতে "insert" কমান্ডের জন্য সাহায্য টেক্সট যোগ করা। insert কমান্ডের জন্য সাহায্য টেক্সট অন্তর্ভুক্ত করার জন্য printUsageAndExit() পদ্ধতিতে নিম্নলিখিত কোড লাইন যোগ করুন:

    System.out.println("  java -jar leaderboard.jar insert my-instance example-db players");
    System.out.println("      - Insert 100 sample Player records into the database.\n");
    System.out.println("  java -jar leaderboard.jar insert my-instance example-db scores");
    System.out.println("      - Insert sample score data into Scores sample Cloud Spanner "
        + "database table.\n");

ক্লাউড শেল এডিটরের "ফাইল" মেনুর অধীনে "সংরক্ষণ করুন" নির্বাচন করে App.java ফাইলে আপনার করা পরিবর্তনগুলি সংরক্ষণ করুন।

কোড যোগ করার পর আপনার App.java ফাইলটি কেমন দেখাবে তার একটি উদাহরণ দেখতে আপনি java-docs-samples/spanner/leaderboard/step5/src ডিরেক্টরিতে App.java ফাইলটি ব্যবহার করতে পারেন। insert কমান্ড সক্রিয় করার জন্য কোডটি যোগ করার পরে আপনার App.java ফাইলটি কেমন দেখাবে তার একটি উদাহরণ দেখুন।

এখন অ্যাপটি পুনর্নির্মাণ এবং রান করা যাক যাতে নিশ্চিত করা যায় যে নতুন insert কমান্ডটি অ্যাপের সম্ভাব্য কমান্ডের তালিকায় অন্তর্ভুক্ত।

আপনার অ্যাপ তৈরি করতে, আপনার pom.xml যে ডিরেক্টরিতে অবস্থিত সেখান থেকে mvn package চালান:

mvn package

আপনার জাভা জার ফাইলটি সফলভাবে তৈরি হয়ে গেলে, নিম্নলিখিত কমান্ডটি চালান:

java -jar target/leaderboard.jar

অ্যাপের ডিফল্ট আউটপুটে এখন আপনি insert কমান্ডটি দেখতে পাবেন:

Leaderboard 1.0.0
Usage:
  java -jar leaderboard.jar <command> <instance_id> <database_id> [command_option]

Examples:
  java -jar leaderboard.jar create my-instance example-db
      - Create a sample Cloud Spanner database along with sample tables in your project.

  java -jar leaderboard.jar insert my-instance example-db players
      - Insert 100 sample Player records into the database.

  java -jar leaderboard.jar insert my-instance example-db scores
      - Insert sample score data into Scores sample Cloud Spanner database table.

আপনি উত্তর থেকে দেখতে পাচ্ছেন যে ইনস্ট্যান্স আইডি এবং ডাটাবেস আইডি ছাড়াও আরেকটি যুক্তি আছে যার মান 'খেলোয়াড়' বা 'স্কোর' হতে পারে।

এখন create কমান্ড কল করার সময় আমরা যে একই আর্গুমেন্ট মান ব্যবহার করে insert কমান্ডটি চালাই, অতিরিক্ত "টাইপ অফ ইনসার্ট" আর্গুমেন্ট হিসেবে "players" যোগ করি।

java -jar target/leaderboard.jar insert cloudspanner-leaderboard leaderboard players

কয়েক সেকেন্ড পরে আপনি নিচের মত একটি প্রতিক্রিয়া দেখতে পাবেন:

Done inserting player records...

এবার জাভা ক্লায়েন্ট লাইব্রেরি ব্যবহার করে আমাদের Scores টেবিলে চারটি র‍্যান্ডম স্কোর এবং Players টেবিলের প্রতিটি প্লেয়ারের জন্য টাইমস্ট্যাম্প তৈরি করা যাক।

Scores টেবিলের Timestamp কলামটিকে নিম্নলিখিত SQL স্টেটমেন্টের মাধ্যমে "কমিট টাইমস্ট্যাম্প" কলাম হিসাবে সংজ্ঞায়িত করা হয়েছিল যা আমরা পূর্বে create কমান্ড চালানোর সময় কার্যকর করা হয়েছিল:

CREATE TABLE Scores(
  PlayerId INT64 NOT NULL,
  Score INT64 NOT NULL,
  Timestamp TIMESTAMP NOT NULL OPTIONS(allow_commit_timestamp=true)
) PRIMARY KEY(PlayerId, Timestamp),
    INTERLEAVE IN PARENT Players ON DELETE NO ACTION

OPTIONS(allow_commit_timestamp=true) অ্যাট্রিবিউটটি লক্ষ্য করুন। এটি Timestamp একটি "কমিট টাইমস্ট্যাম্প" কলাম করে তোলে এবং একটি প্রদত্ত টেবিল সারিতে INSERT এবং UPDATE ক্রিয়াকলাপের জন্য সঠিক লেনদেনের টাইমস্ট্যাম্প দিয়ে এটি স্বয়ংক্রিয়ভাবে পূর্ণ হতে সক্ষম করে।

আপনি "কমিট টাইমস্ট্যাম্প" কলামে আপনার নিজস্ব টাইমস্ট্যাম্প মানগুলিও সন্নিবেশ করতে পারেন যতক্ষণ না আপনি অতীতের মান সহ একটি টাইমস্ট্যাম্প সন্নিবেশ করেন, যা আমরা এই কোডল্যাবের উদ্দেশ্যে করব।

এখন আসুন insert কমান্ডটি একই আর্গুমেন্ট মান সহ রান করি যা আমরা create কমান্ড কল করার সময় ব্যবহার করেছিলাম এবং অতিরিক্ত "টাইপ অফ ইনসার্ট" আর্গুমেন্ট হিসেবে "scores" যোগ করেছিলাম।

java -jar target/leaderboard.jar insert cloudspanner-leaderboard leaderboard scores

কয়েক সেকেন্ড পরে আপনি নিচের মত একটি প্রতিক্রিয়া দেখতে পাবেন:

Done inserting score records...

scores হিসেবে নির্দিষ্ট "টাইপ অফ ইনসার্ট" দিয়ে insert চালানোর জন্য insertScores পদ্ধতিটি কল করা হয় যা নিম্নলিখিত কোড স্নিপেটগুলি ব্যবহার করে অতীতে ঘটে যাওয়া তারিখ-সময় সহ একটি এলোমেলোভাবে তৈরি টাইমস্ট্যাম্প সন্নিবেশ করায়:

          LocalDate endDate = LocalDate.now();
          long end = endDate.toEpochDay();
          int startYear = endDate.getYear() - 2;
          int startMonth = endDate.getMonthValue();
          int startDay = endDate.getDayOfMonth();
          LocalDate startDate = LocalDate.of(startYear, startMonth, startDay);
          long start = startDate.toEpochDay();
...
            long randomDay = ThreadLocalRandom.current().nextLong(start, end);
            LocalDate randomDayDate = LocalDate.ofEpochDay(randomDay);
            LocalTime randomTime = LocalTime.of(
                        r.nextInt(23), r.nextInt(59), r.nextInt(59), r.nextInt(9999));
            LocalDateTime randomDate = LocalDateTime.of(randomDayDate, randomTime);
            Instant randomInstant = randomDate.toInstant(ZoneOffset.UTC);

...
               .bind("Timestamp")
               .to(randomInstant.toString())

"Insert" লেনদেন ঠিক কখন হবে তার টাইমস্ট্যাম্প দিয়ে Timestamp কলামে স্বয়ংক্রিয়ভাবে পূর্ণ করার জন্য, আপনি নিম্নলিখিত কোড স্নিপেটের মতো জাভা ধ্রুবক Value.COMMIT_TIMESTAMP সন্নিবেশ করতে পারেন:

               .bind("Timestamp")
               .to(Value.COMMIT_TIMESTAMP)

এখন যেহেতু আমরা ডেটা লোডিং সম্পন্ন করেছি, আসুন আমাদের নতুন টেবিলে লেখা মানগুলি যাচাই করি। প্রথমে leaderboard ডাটাবেস নির্বাচন করুন এবং তারপর Players টেবিল নির্বাচন করুন। Data ট্যাবে ক্লিক করুন। আপনি দেখতে পাবেন যে টেবিলের PlayerId এবং PlayerName কলামে আপনার ডেটা আছে।

7bc2c96293c31c49.png সম্পর্কে

এরপর Scores টেবিলে ক্লিক করে Data ট্যাব নির্বাচন করে Scores টেবিলেও ডেটা আছে কিনা তা যাচাই করা যাক। আপনি দেখতে পাবেন যে টেবিলের PlayerId , Timestamp এবং Score কলামে আপনার ডেটা আছে।

d8a4ee4f13244c19.png সম্পর্কে

দারুন! আসুন আমাদের অ্যাপটি আপডেট করি যাতে কিছু কোয়েরি চালানো যায় যা দিয়ে আমরা একটি গেমিং লিডারবোর্ড তৈরি করতে পারি।

৬. লিডারবোর্ড কোয়েরি চালান

এখন যেহেতু আমরা আমাদের ডাটাবেস সেট আপ করেছি এবং আমাদের টেবিলে তথ্য লোড করেছি, আসুন এই ডেটা ব্যবহার করে একটি লিডারবোর্ড তৈরি করি। এটি করার জন্য আমাদের নিম্নলিখিত চারটি প্রশ্নের উত্তর দিতে হবে:

  1. সর্বকালের "শীর্ষ দশ" খেলোয়াড় কোন কোন?
  2. বছরের "শীর্ষ দশ" খেলোয়াড় কোন কোন?
  3. মাসের "শীর্ষ দশ" খেলোয়াড় কোন কোন?
  4. সপ্তাহের "সেরা দশ" খেলোয়াড় কোন কোন?

এই প্রশ্নের উত্তর দেওয়া SQL কোয়েরিগুলি চালানোর জন্য আমাদের অ্যাপটি আপডেট করা যাক।

আমরা একটি query কমান্ড যুক্ত করব যা আমাদের লিডারবোর্ডের জন্য প্রয়োজনীয় তথ্য তৈরি করবে এমন প্রশ্নের উত্তর দেওয়ার জন্য কোয়েরিগুলি চালানোর একটি উপায় প্রদান করবে।

ক্লাউড শেল এডিটরে App.java ফাইলটি সম্পাদনা করে অ্যাপটি আপডেট করে একটি query কমান্ড যোগ করুন। query কমান্ড দুটি query পদ্ধতি নিয়ে গঠিত, একটি যা শুধুমাত্র একটি DatabaseClient আর্গুমেন্ট নেয় এবং অন্যটি যা ঘন্টার মধ্যে নির্দিষ্ট টাইমস্প্যান দ্বারা ফলাফল ফিল্টার করার সুবিধার্থে একটি অতিরিক্ত timespan আর্গুমেন্ট নেয়।

বিদ্যমান insertScores() পদ্ধতির নিচে এবং বিদ্যমান printUsageAndExit() পদ্ধতির উপরে নিম্নলিখিত দুটি query পদ্ধতি যোগ করুন:

  static void query(DatabaseClient dbClient) {
    String scoreDate;
    String score;
    ResultSet resultSet =
        dbClient
            .singleUse()
            .executeQuery(
                Statement.of(
                    "SELECT p.PlayerId, p.PlayerName, s.Score, s.Timestamp "
                        + "FROM Players p "
                        + "JOIN Scores s ON p.PlayerId = s.PlayerId "
                        + "ORDER BY s.Score DESC LIMIT 10"));
    while (resultSet.next()) {
      scoreDate = String.valueOf(resultSet.getTimestamp("Timestamp"));
      score = String.format("%,d", resultSet.getLong("Score"));
      System.out.printf(
          "PlayerId: %d  PlayerName: %s  Score: %s  Timestamp: %s\n",
          resultSet.getLong("PlayerId"), resultSet.getString("PlayerName"), score,
          scoreDate.substring(0,10));
    }
  }

  static void query(DatabaseClient dbClient, int timespan) {
    String scoreDate;
    String score;
    Statement statement =
        Statement
            .newBuilder(
              "SELECT p.PlayerId, p.PlayerName, s.Score, s.Timestamp "
              + "FROM Players p "
              + "JOIN Scores s ON p.PlayerId = s.PlayerId "
              + "WHERE s.Timestamp > "
              + "TIMESTAMP_SUB(CURRENT_TIMESTAMP(), "
              + "    INTERVAL @Timespan HOUR) "
              + "ORDER BY s.Score DESC LIMIT 10")
            .bind("Timespan")
            .to(timespan)
            .build();
    ResultSet resultSet =
        dbClient
            .singleUse()
            .executeQuery(statement);
    while (resultSet.next()) {
      scoreDate = String.valueOf(resultSet.getTimestamp("Timestamp"));
      score = String.format("%,d", resultSet.getLong("Score"));
      System.out.printf(
          "PlayerId: %d  PlayerName: %s  Score: %s  Timestamp: %s\n",
          resultSet.getLong("PlayerId"), resultSet.getString("PlayerName"), score,
          scoreDate.substring(0,10));
    }
  }

তারপর, query কমান্ডটি কার্যকরী করতে, আপনার অ্যাপের "main" পদ্ধতিতে switch(command) স্টেটমেন্টে নিম্নলিখিত কোডটি যোগ করুন:

        case "query":
          if (args.length == 4) {
            int timespan = 0;
            try {
              timespan = Integer.parseInt(args[3]);
            } catch (NumberFormatException e) {
              System.err.println("query command's 'timespan' parameter must be a valid integer.");
              System.exit(1);
            }
            query(dbClient, timespan);
          } else {
            query(dbClient);
          }
          break;

আপনার অ্যাপে "query" কার্যকারিতা যোগ করার শেষ ধাপ হল printUsageAndExit() পদ্ধতিতে "query" কমান্ডের জন্য সাহায্য টেক্সট যোগ করা। "query" কমান্ডের জন্য সাহায্য টেক্সট অন্তর্ভুক্ত করার জন্য printUsageAndExit() পদ্ধতিতে নিম্নলিখিত কোড লাইন যোগ করুন:

    System.out.println("  java -jar leaderboard.jar query my-instance example-db");
    System.out.println("      - Query players with top ten scores of all time.\n");
    System.out.println("  java -jar leaderboard.jar query my-instance example-db 168");
    System.out.println("      - Query players with top ten scores within a timespan "
        + "specified in hours.\n");

ক্লাউড শেল এডিটরের "ফাইল" মেনুর অধীনে "সংরক্ষণ করুন" নির্বাচন করে App.java ফাইলে আপনার করা পরিবর্তনগুলি সংরক্ষণ করুন।

query কমান্ড সক্রিয় করার জন্য কোড যোগ করার পরে আপনার App.java ফাইলটি কেমন দেখাবে তার একটি উদাহরণ দেখতে আপনি dotnet-docs-samples/applications/leaderboard/step6/src ডিরেক্টরিতে App.java ফাইলটি ব্যবহার করতে পারেন।

আপনার অ্যাপ তৈরি করতে, আপনার pom.xml যে ডিরেক্টরিতে অবস্থিত সেখান থেকে mvn package চালান:

mvn package

এবার অ্যাপটি রান করে নিশ্চিত করা যাক যে নতুন query কমান্ডটি অ্যাপের সম্ভাব্য কমান্ডের তালিকায় অন্তর্ভুক্ত আছে। নিম্নলিখিত কমান্ডটি চালান:

java -jar target/leaderboard.jar

আপনি এখন অ্যাপের ডিফল্ট আউটপুটে একটি নতুন কমান্ড বিকল্প হিসেবে query কমান্ডটি অন্তর্ভুক্ত দেখতে পাবেন:

Leaderboard 1.0.0
Usage:
  java -jar leaderboard.jar <command> <instance_id> <database_id> [command_option]

Examples:
  java -jar leaderboard.jar create my-instance example-db
      - Create a sample Cloud Spanner database along with sample tables in your project.

  java -jar leaderboard.jar insert my-instance example-db players
      - Insert 100 sample Player records into the database.

  java -jar leaderboard.jar insert my-instance example-db scores
      - Insert sample score data into Scores sample Cloud Spanner database table.

  java -jar leaderboard.jar query my-instance example-db
      - Query players with top ten scores of all time.

  java -jar leaderboard.jar query my-instance example-db 168
      - Query players with top ten scores within a timespan specified in hours.

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

"টাইমস্প্যান" নির্দিষ্ট না করেই query কমান্ডটি রান করা যাক, create কমান্ড চালানোর সময় আমরা যে আর্গুমেন্ট মান ব্যবহার করেছিলাম, সেই একই মান ব্যবহার করে।

java -jar target/leaderboard.jar query cloudspanner-leaderboard leaderboard

আপনি এমন একটি প্রতিক্রিয়া দেখতে পাবেন যেখানে সর্বকালের "শীর্ষ দশ" খেলোয়াড়দের অন্তর্ভুক্ত থাকবে, যেমন:

PlayerId: 4018687297  PlayerName: Player 83  Score: 999,618  Timestamp: 2017-07-01
PlayerId: 4018687297  PlayerName: Player 83  Score: 998,956  Timestamp: 2017-09-02
PlayerId: 4285713246  PlayerName: Player 51  Score: 998,648  Timestamp: 2017-12-01
PlayerId: 5267931774  PlayerName: Player 49  Score: 997,733  Timestamp: 2017-11-09
PlayerId: 1981654448  PlayerName: Player 35  Score: 997,480  Timestamp: 2018-12-06
PlayerId: 4953940705  PlayerName: Player 87  Score: 995,184  Timestamp: 2018-09-14
PlayerId: 2456736905  PlayerName: Player 84  Score: 992,881  Timestamp: 2017-04-14
PlayerId: 8234617611  PlayerName: Player 19  Score: 992,399  Timestamp: 2017-12-27
PlayerId: 1788051688  PlayerName: Player 76  Score: 992,265  Timestamp: 2018-11-22
PlayerId: 7127686505  PlayerName: Player 97  Score: 992,038  Timestamp: 2017-12-02

এবার আসুন, "শীর্ষ দশ" খেলোয়াড়দের জিজ্ঞাসা করার জন্য প্রয়োজনীয় আর্গুমেন্ট সহ query কমান্ডটি চালাই, যা বছরে ঘন্টার সংখ্যার সমান "সময়কাল" নির্দিষ্ট করে, যা 8760।

java -jar target/leaderboard.jar query cloudspanner-leaderboard leaderboard 8760

আপনি এমন একটি প্রতিক্রিয়া দেখতে পাবেন যেখানে বছরের "শীর্ষ দশ" খেলোয়াড়দের নাম অন্তর্ভুক্ত থাকবে, যেমন:

PlayerId: 1981654448  PlayerName: Player 35  Score: 997,480  Timestamp: 2018-12-06
PlayerId: 4953940705  PlayerName: Player 87  Score: 995,184  Timestamp: 2018-09-14
PlayerId: 1788051688  PlayerName: Player 76  Score: 992,265  Timestamp: 2018-11-22
PlayerId: 6862349579  PlayerName: Player 30  Score: 990,877  Timestamp: 2018-09-14
PlayerId: 5529627211  PlayerName: Player 16  Score: 989,142  Timestamp: 2018-03-30
PlayerId: 9743904155  PlayerName: Player 1  Score: 988,765  Timestamp: 2018-05-30
PlayerId: 6809119884  PlayerName: Player 7  Score: 986,673  Timestamp: 2018-05-16
PlayerId: 2132710638  PlayerName: Player 54  Score: 983,108  Timestamp: 2018-09-11
PlayerId: 2320093590  PlayerName: Player 79  Score: 981,373  Timestamp: 2018-05-07
PlayerId: 9554181430  PlayerName: Player 80  Score: 981,087  Timestamp: 2018-06-21

এবার আসুন মাসের "শীর্ষ দশ" খেলোয়াড়দের জিজ্ঞাসা করার জন্য query কমান্ডটি চালাই, যা মাসে ঘন্টার সংখ্যার সমান "সময়কাল" নির্দিষ্ট করে, যা 730।

java -jar target/leaderboard.jar query cloudspanner-leaderboard leaderboard 730

আপনি নিম্নলিখিতগুলির মতো মাসের "শীর্ষ দশ" খেলোয়াড়দের অন্তর্ভুক্ত একটি প্রতিক্রিয়া দেখতে পাবেন:

PlayerId: 3869829195  PlayerName: Player 69  Score: 949,686  Timestamp: 2019-02-19
PlayerId: 7448359883  PlayerName: Player 20  Score: 938,998  Timestamp: 2019-02-07
PlayerId: 1981654448  PlayerName: Player 35  Score: 929,003  Timestamp: 2019-02-22
PlayerId: 9336678658  PlayerName: Player 44  Score: 914,106  Timestamp: 2019-01-27
PlayerId: 6968576389  PlayerName: Player 40  Score: 898,041  Timestamp: 2019-02-21
PlayerId: 5529627211  PlayerName: Player 16  Score: 896,433  Timestamp: 2019-01-29
PlayerId: 9395039625  PlayerName: Player 59  Score: 879,495  Timestamp: 2019-02-09
PlayerId: 2094604854  PlayerName: Player 39  Score: 860,434  Timestamp: 2019-02-01
PlayerId: 9395039625  PlayerName: Player 59  Score: 849,955  Timestamp: 2019-02-21
PlayerId: 4285713246  PlayerName: Player 51  Score: 805,654  Timestamp: 2019-02-02

এবার আসুন সপ্তাহের "শীর্ষ দশ" খেলোয়াড়দের জিজ্ঞাসা করার জন্য query কমান্ডটি চালাই, সপ্তাহে যত ঘন্টা সময় লাগে তার সমান "সময়কাল" নির্দিষ্ট করে, যা হল ১৬৮।

java -jar target/leaderboard.jar query cloudspanner-leaderboard leaderboard 168

আপনি সপ্তাহের "শীর্ষ দশ" খেলোয়াড়দের অন্তর্ভুক্ত করে একটি প্রতিক্রিয়া দেখতে পাবেন, যেমন:

PlayerId: 3869829195  PlayerName: Player 69  Score: 949,686  Timestamp: 2019-02-19
PlayerId: 1981654448  PlayerName: Player 35  Score: 929,003  Timestamp: 2019-02-22
PlayerId: 6968576389  PlayerName: Player 40  Score: 898,041  Timestamp: 2019-02-21
PlayerId: 9395039625  PlayerName: Player 59  Score: 849,955  Timestamp: 2019-02-21
PlayerId: 5954045812  PlayerName: Player 8  Score: 795,639  Timestamp: 2019-02-22
PlayerId: 3889939638  PlayerName: Player 71  Score: 775,252  Timestamp: 2019-02-21
PlayerId: 5529627211  PlayerName: Player 16  Score: 604,695  Timestamp: 2019-02-19
PlayerId: 9006728426  PlayerName: Player 3  Score: 457,208  Timestamp: 2019-02-22
PlayerId: 8289497066  PlayerName: Player 58  Score: 227,697  Timestamp: 2019-02-20
PlayerId: 8065482904  PlayerName: Player 99  Score: 198,429  Timestamp: 2019-02-24

দারুন কাজ!

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

৭. পরিষ্কার-পরিচ্ছন্নতা

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

৮. অভিনন্দন!

আমরা যা কভার করেছি:

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

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

আপনার মতামত জানান

  • আমাদের খুব ছোট জরিপটি সম্পূর্ণ করার জন্য একটু সময় নিন।