1. ওভারভিউ
Google ক্লাউড স্প্যানার হল একটি সম্পূর্ণরূপে পরিচালিত অনুভূমিকভাবে স্কেলযোগ্য, বিশ্বব্যাপী বিতরণ করা, রিলেশনাল ডাটাবেস পরিষেবা যা কর্মক্ষমতা এবং উচ্চ প্রাপ্যতা ছেড়ে না দিয়ে ACID লেনদেন এবং SQL শব্দার্থবিদ্যা প্রদান করে৷
এই ল্যাবে, আপনি শিখবেন কিভাবে একটি ক্লাউড স্প্যানার ইনস্ট্যান্স সেটআপ করতে হয়। আপনি একটি ডাটাবেস এবং স্কিমা তৈরির ধাপগুলি অতিক্রম করবেন যা একটি গেমিং লিডারবোর্ডের জন্য ব্যবহার করা যেতে পারে। আপনি প্লেয়ারের তথ্য সঞ্চয় করার জন্য একটি প্লেয়ার টেবিল এবং প্লেয়ারের স্কোর সঞ্চয় করার জন্য একটি স্কোর টেবিল তৈরি করে শুরু করবেন।
এরপরে আপনি নমুনা ডেটা সহ টেবিলগুলি পূরণ করবেন। তারপরে আপনি কিছু শীর্ষ দশটি নমুনা প্রশ্নগুলি চালিয়ে এবং শেষ পর্যন্ত সংস্থানগুলি খালি করার জন্য উদাহরণটি মুছে ফেলার মাধ্যমে ল্যাবটি শেষ করবেন।
আপনি কি শিখবেন
- একটি ক্লাউড স্প্যানার উদাহরণ কিভাবে সেটআপ করবেন।
- কিভাবে একটি ডাটাবেস এবং টেবিল তৈরি করতে হয়।
- একটি কমিট টাইমস্ট্যাম্প কলাম কিভাবে ব্যবহার করবেন।
- টাইমস্ট্যাম্প সহ আপনার ক্লাউড স্প্যানার ডাটাবেস টেবিলে কীভাবে ডেটা লোড করবেন।
- আপনার ক্লাউড স্প্যানার ডাটাবেসকে কীভাবে জিজ্ঞাসা করবেন।
- কিভাবে আপনার ক্লাউড স্প্যানার ইনস্ট্যান্স মুছে ফেলবেন।
W****আপনার কি লাগবে
- একটি ওয়েব ব্রাউজার, যেমন ক্রোম বা ফায়ারফক্স ।
আপনি কিভাবে এই টিউটোরিয়াল ব্যবহার করবেন?
আপনি Google ক্লাউড প্ল্যাটফর্মের সাথে আপনার অভিজ্ঞতাকে কীভাবে মূল্যায়ন করবেন?
2. সেটআপ এবং প্রয়োজনীয়তা
স্ব-গতিসম্পন্ন পরিবেশ সেটআপ
আপনার যদি ইতিমধ্যে একটি Google অ্যাকাউন্ট না থাকে (Gmail বা Google Apps), তাহলে আপনাকে অবশ্যই একটি তৈরি করতে হবে। Google ক্লাউড প্ল্যাটফর্ম কনসোলে সাইন-ইন করুন ( console.cloud.google.com ) এবং একটি নতুন প্রকল্প তৈরি করুন৷
আপনার যদি ইতিমধ্যে একটি প্রকল্প থাকে, তাহলে কনসোলের উপরের বাম দিকে প্রজেক্ট নির্বাচন পুল ডাউন মেনুতে ক্লিক করুন:
এবং একটি নতুন প্রকল্প তৈরি করতে ফলাফল ডায়ালগে 'নতুন প্রকল্প' বোতামে ক্লিক করুন:
আপনার যদি ইতিমধ্যে একটি প্রকল্প না থাকে, তাহলে আপনার প্রথমটি তৈরি করতে আপনাকে এই মত একটি ডায়ালগ দেখতে হবে:
পরবর্তী প্রকল্প তৈরির ডায়ালগ আপনাকে আপনার নতুন প্রকল্পের বিশদ বিবরণ প্রবেশ করতে দেয়:
প্রজেক্ট আইডিটি মনে রাখবেন, যা সমস্ত Google ক্লাউড প্রকল্প জুড়ে একটি অনন্য নাম (উপরের নামটি ইতিমধ্যে নেওয়া হয়েছে এবং আপনার জন্য কাজ করবে না, দুঃখিত!)। এটি পরে এই কোডল্যাবে PROJECT_ID হিসাবে উল্লেখ করা হবে।
পরবর্তী, যদি আপনি ইতিমধ্যে এটি না করে থাকেন, তাহলে Google ক্লাউড সংস্থানগুলি ব্যবহার করতে এবং ক্লাউড স্প্যানার API সক্ষম করার জন্য আপনাকে বিকাশকারী কনসোলে বিলিং সক্ষম করতে হবে৷
এই কোডল্যাবের মাধ্যমে চালানোর জন্য আপনার কয়েক ডলারের বেশি খরচ করা উচিত নয়, তবে আপনি যদি আরও সংস্থান ব্যবহার করার সিদ্ধান্ত নেন বা আপনি যদি সেগুলিকে চলমান রেখে দেন তবে এটি আরও বেশি হতে পারে (এই নথির শেষে "পরিষ্কার" বিভাগটি দেখুন)। Google ক্লাউড স্প্যানার মূল্য এখানে নথিভুক্ত করা হয়েছে।
Google ক্লাউড প্ল্যাটফর্মের নতুন ব্যবহারকারীরা $300 বিনামূল্যের ট্রায়ালের জন্য যোগ্য, যা এই কোডল্যাবটিকে সম্পূর্ণ বিনামূল্যে করতে হবে৷
গুগল ক্লাউড শেল সেটআপ
যদিও Google ক্লাউড এবং স্প্যানার আপনার ল্যাপটপ থেকে দূরবর্তীভাবে পরিচালিত হতে পারে, এই কোডল্যাবে আমরা Google ক্লাউড শেল ব্যবহার করব, ক্লাউডে চলমান একটি কমান্ড লাইন পরিবেশ।
এই ডেবিয়ান-ভিত্তিক ভার্চুয়াল মেশিনটি আপনার প্রয়োজনীয় সমস্ত বিকাশের সরঞ্জামগুলির সাথে লোড করা হয়েছে। এটি একটি ক্রমাগত 5GB হোম ডিরেক্টরি অফার করে এবং Google ক্লাউডে চলে, যা নেটওয়ার্ক কর্মক্ষমতা এবং প্রমাণীকরণকে ব্যাপকভাবে উন্নত করে। এর মানে হল যে এই কোডল্যাবের জন্য আপনার যা দরকার তা হল একটি ব্রাউজার (হ্যাঁ, এটি একটি Chromebook এ কাজ করে)।
- ক্লাউড কনসোল থেকে ক্লাউড শেল সক্রিয় করতে, কেবল ক্লাউড শেল সক্রিয় করুন ক্লিক করুন
(পরিবেশের সাথে সংযোগ স্থাপন এবং সংযোগের জন্য এটি শুধুমাত্র কয়েক মুহূর্ত নিতে হবে)।
একবার ক্লাউড শেলের সাথে সংযুক্ত হয়ে গেলে, আপনি দেখতে পাবেন যে আপনি ইতিমধ্যেই প্রমাণীকৃত এবং প্রকল্পটি ইতিমধ্যেই আপনার 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 খুঁজছেন? সেটআপ ধাপে আপনি কোন আইডি ব্যবহার করেছেন তা দেখুন বা ক্লাউড কনসোল ড্যাশবোর্ডে দেখুন:
ক্লাউড শেল ডিফল্টরূপে কিছু এনভায়রনমেন্ট ভেরিয়েবলও সেট করে, যা আপনার ভবিষ্যত কমান্ড চালানোর সময় কার্যকর হতে পারে।
echo $GOOGLE_CLOUD_PROJECT
কমান্ড আউটপুট
<PROJECT_ID>
- অবশেষে, ডিফল্ট জোন এবং প্রকল্প কনফিগারেশন সেট করুন।
gcloud config set compute/zone us-central1-f
আপনি বিভিন্ন জোন বিভিন্ন চয়ন করতে পারেন. আরও তথ্যের জন্য, অঞ্চল এবং অঞ্চল দেখুন।
সারাংশ
এই ধাপে, আপনি আপনার পরিবেশ সেট আপ করুন।
পরবর্তী আপ
এরপরে, আপনি একটি ক্লাউড স্প্যানার ইনস্ট্যান্স সেটআপ করবেন।
3. একটি ক্লাউড স্প্যানার ইনস্ট্যান্স সেটআপ করুন৷
এই ধাপে আমরা এই কোডল্যাবের জন্য আমাদের ক্লাউড স্প্যানার ইনস্ট্যান্স সেটআপ করি। স্প্যানার এন্ট্রি জন্য অনুসন্ধান করুন 
বাম উপরের হ্যামবার্গার মেনুতে 
অথবা "/" টিপে স্প্যানার অনুসন্ধান করুন এবং "স্প্যানার" টাইপ করুন
পরবর্তী, ক্লিক করুন 
এবং আপনার উদাহরণের জন্য ক্লাউডস্প্যানার-লিডারবোর্ডের ইনস্ট্যান্স নামটি প্রবেশ করে ফর্মটি পূরণ করুন, একটি কনফিগারেশন নির্বাচন করুন (একটি আঞ্চলিক উদাহরণ নির্বাচন করুন) এবং নোডের সংখ্যা সেট করুন, এই কোডল্যাবের জন্য আমাদের শুধুমাত্র 1 নোডের প্রয়োজন হবে। উৎপাদন দৃষ্টান্তের জন্য এবং ক্লাউড স্প্যানার এসএলএ-এর জন্য যোগ্যতা অর্জন করতে আপনাকে আপনার ক্লাউড স্প্যানার দৃষ্টান্তে 3 বা তার বেশি নোড চালাতে হবে।
সবশেষে, কিন্তু অন্তত নয়, "তৈরি করুন" এ ক্লিক করুন এবং কয়েক সেকেন্ডের মধ্যে আপনার হাতে একটি ক্লাউড স্প্যানার ইনস্ট্যান্স আছে।
পরবর্তী ধাপে আমরা আমাদের নতুন উদাহরণে একটি ডাটাবেস এবং স্কিমা তৈরি করতে Go ক্লায়েন্ট লাইব্রেরি ব্যবহার করতে যাচ্ছি।
4. একটি ডাটাবেস এবং স্কিমা তৈরি করুন
এই ধাপে আমরা আমাদের নমুনা ডাটাবেস এবং স্কিমা তৈরি করতে যাচ্ছি।
আসুন দুটি টেবিল তৈরি করতে Go ক্লায়েন্ট লাইব্রেরি ব্যবহার করি; প্লেয়ারের তথ্যের জন্য একটি প্লেয়ার টেবিল এবং প্লেয়ারের স্কোর সংরক্ষণের জন্য একটি স্কোর টেবিল। এটি করার জন্য আমরা ক্লাউড শেল-এ একটি গো কনসোল অ্যাপ্লিকেশন তৈরি করার ধাপগুলি অনুসরণ করব।
প্রথমে ক্লাউড শেলে নিম্নলিখিত কমান্ডটি টাইপ করে Github থেকে এই কোডল্যাবের নমুনা কোডটি ক্লোন করুন:
export GO111MODULE=auto
go get -u github.com/GoogleCloudPlatform/golang-samples/spanner/...
তারপরে "লিডারবোর্ড" ডিরেক্টরিতে ডিরেক্টরি পরিবর্তন করুন যেখানে আপনি আপনার অ্যাপ্লিকেশন তৈরি করবেন।
cd gopath/src/github.com/GoogleCloudPlatform/golang-samples/spanner/spanner_leaderboard
এই কোডল্যাবের জন্য প্রয়োজনীয় সমস্ত কোড বিদ্যমান golang-samples/spanner/spanner_leaderboard/ ডিরেক্টরিতে leaderboard নামে একটি রানযোগ্য গো অ্যাপ্লিকেশন হিসেবে কোডল্যাবের মাধ্যমে অগ্রগতির সাথে সাথে রেফারেন্স হিসাবে পরিবেশন করা হয়। আমরা একটি নতুন ডিরেক্টরি তৈরি করব এবং পর্যায়ক্রমে লিডারবোর্ড অ্যাপ্লিকেশনটির একটি অনুলিপি তৈরি করব।
অ্যাপ্লিকেশনটির জন্য "কোডেল্যাব" নামে একটি নতুন ডিরেক্টরি তৈরি করুন এবং নিম্নলিখিত কমান্ডের সাথে এটিতে ডিরেক্টরি পরিবর্তন করুন:
mkdir codelab && cd $_
এখন আসুন "লিডারবোর্ড" নামে একটি মৌলিক গো অ্যাপ্লিকেশন তৈরি করি যা দুটি টেবিলের সমন্বয়ে একটি লিডারবোর্ড তৈরি করতে স্প্যানার ক্লায়েন্ট লাইব্রেরি ব্যবহার করে; খেলোয়াড় এবং স্কোর। আপনি ক্লাউড শেল এডিটরে এটি করতে পারেন:
নীচে হাইলাইট করা "ওপেন এডিটর" আইকনে ক্লিক করে ক্লাউড শেল এডিটর খুলুন:
~/gopath/src/github.com/GoogleCloudPlatform/golang-samples/spanner/codelab ফোল্ডারে "leaderboard.go" নামে একটি ফাইল তৈরি করুন।
- প্রথমে নিশ্চিত হন যে আপনি ক্লাউড শেল এডিটরের ফোল্ডারের তালিকায় "কোডল্যাব" ফোল্ডারটি নির্বাচিত করেছেন।
- তারপর ক্লাউড শেল এডিটরের "ফাইল" মেনুর অধীনে "নতুন ফাইল" নির্বাচন করুন।
- নতুন ফাইলের নাম হিসেবে "leaderboard.go" লিখুন।
এটি অ্যাপ্লিকেশনটির প্রধান ফাইল যাতে আমাদের অ্যাপ্লিকেশন কোড এবং কোনো নির্ভরতা অন্তর্ভুক্ত করার জন্য উল্লেখ থাকবে।
leaderboard ডাটাবেস এবং Players এবং Scores টেবিল তৈরি করতে, leaderboard.go ফাইলে নিম্নলিখিত গো কোডটি কপি করুন (Ctrl + P) এবং পেস্ট করুন (Ctrl + V):
package main
import (
"context"
"flag"
"fmt"
"io"
"log"
"os"
"regexp"
"time"
"cloud.google.com/go/spanner"
database "cloud.google.com/go/spanner/admin/database/apiv1"
adminpb "google.golang.org/genproto/googleapis/spanner/admin/database/v1"
)
type adminCommand func(ctx context.Context, w io.Writer, adminClient *database.DatabaseAdminClient, database string) error
func createDatabase(ctx context.Context, w io.Writer, adminClient *database.DatabaseAdminClient, db string) error {
matches := regexp.MustCompile("^(.*)/databases/(.*)$").FindStringSubmatch(db)
if matches == nil || len(matches) != 3 {
return fmt.Errorf("Invalid database id %s", db)
}
op, err := adminClient.CreateDatabase(ctx, &adminpb.CreateDatabaseRequest{
Parent: matches[1],
CreateStatement: "CREATE DATABASE `" + matches[2] + "`",
ExtraStatements: []string{
`CREATE TABLE Players(
PlayerId INT64 NOT NULL,
PlayerName STRING(2048) NOT NULL
) PRIMARY KEY(PlayerId)`,
`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`,
},
})
if err != nil {
return err
}
if _, err := op.Wait(ctx); err != nil {
return err
}
fmt.Fprintf(w, "Created database [%s]\n", db)
return nil
}
func createClients(ctx context.Context, db string) (*database.DatabaseAdminClient, *spanner.Client) {
adminClient, err := database.NewDatabaseAdminClient(ctx)
if err != nil {
log.Fatal(err)
}
dataClient, err := spanner.NewClient(ctx, db)
if err != nil {
log.Fatal(err)
}
return adminClient, dataClient
}
func run(ctx context.Context, adminClient *database.DatabaseAdminClient, dataClient *spanner.Client, w io.Writer,
cmd string, db string, timespan int) error {
// createdatabase command
if cmd == "createdatabase" {
err := createDatabase(ctx, w, adminClient, db)
if err != nil {
fmt.Fprintf(w, "%s failed with %v", cmd, err)
}
return err
}
return nil
}
func main() {
flag.Usage = func() {
fmt.Fprintf(os.Stderr, `Usage: leaderboard <command> <database_name> [command_option]
Command can be one of: createdatabase
Examples:
leaderboard createdatabase projects/my-project/instances/my-instance/databases/example-db
- Create a sample Cloud Spanner database along with sample tables in your project.
`)
}
flag.Parse()
flagCount := len(flag.Args())
if flagCount != 2 {
flag.Usage()
os.Exit(2)
}
cmd, db := flag.Arg(0), flag.Arg(1)
// Set timespan to zero, as it's not currently being used
var timespan int = 0
ctx, cancel := context.WithTimeout(context.Background(), 1*time.Minute)
defer cancel()
adminClient, dataClient := createClients(ctx, db)
if err := run(ctx, adminClient, dataClient, os.Stdout, cmd, db, timespan); err != nil {
os.Exit(1)
}
}
ক্লাউড শেল এডিটরের "ফাইল" মেনুর অধীনে "সংরক্ষণ করুন" নির্বাচন করে leaderboard.go ফাইলে আপনার করা পরিবর্তনগুলি সংরক্ষণ করুন৷
আপনি createdatabase কমান্ড সক্রিয় করার জন্য কোড যোগ করার পরে আপনার leaderboard.go ফাইলটি কীভাবে দেখা উচিত তার একটি উদাহরণ দেখতে golang-samples/spanner/spanner_leaderboard ডিরেক্টরির মধ্যে leaderboard.go ফাইলটি ব্যবহার করতে পারেন।
ক্লাউড শেলে আপনার অ্যাপটি তৈরি করতে codelab ডিরেক্টরি থেকে "গো বিল্ড" চালান যেখানে আপনার leaderboard.go ফাইলটি অবস্থিত:
go build leaderboard.go
একবার আপনার অ্যাপ্লিকেশনটি সফলভাবে তৈরি হয়ে গেলে, নিম্নলিখিত কমান্ডটি প্রবেশ করে ক্লাউড শেলটিতে ফলস্বরূপ অ্যাপ্লিকেশনটি চালান:
./leaderboard
আপনি নিম্নলিখিত মত আউটপুট দেখতে হবে:
Usage: leaderboard <command> <database_name> [command_option]
Command can be one of: createdatabase
Examples:
leaderboard createdatabase projects/my-project/instances/my-instance/databases/example-db
- Create a sample Cloud Spanner database along with sample tables in your project.
এই প্রতিক্রিয়া থেকে আমরা দেখতে পাচ্ছি যে এটি Leaderboard অ্যাপ্লিকেশন যা বর্তমানে একটি সম্ভাব্য কমান্ড রয়েছে: createdatabase । আমরা দেখতে পাচ্ছি যে createdatabase কমান্ডের প্রত্যাশিত আর্গুমেন্টটি একটি নির্দিষ্ট ইনস্ট্যান্স আইডি এবং ডেটাবেস আইডি ধারণকারী একটি স্ট্রিং।
এখন নিম্নলিখিত কমান্ডটি চালান। নিশ্চিত করুন যে আপনি এই কোডল্যাবের শুরুতে তৈরি করা প্রজেক্ট আইডি দিয়ে my-project প্রতিস্থাপন করেছেন।
./leaderboard createdatabase projects/my-project/instances/cloudspanner-leaderboard/databases/leaderboard
কয়েক সেকেন্ড পরে আপনি নিম্নলিখিত মত একটি প্রতিক্রিয়া দেখতে হবে:
Created database [projects/my-project/instances/cloudspanner-leaderboard/databases/leaderboard]
ক্লাউড কনসোলের ক্লাউড স্প্যানার ডাটাবেস ওভারভিউ বিভাগে আপনি বাম দিকের মেনুতে আপনার নতুন ডাটাবেস এবং টেবিলগুলি দেখতে পাবেন।
পরবর্তী ধাপে আমরা আপনার নতুন ডাটাবেসে কিছু ডেটা লোড করার জন্য আমাদের অ্যাপ্লিকেশন আপডেট করব।
5. ডেটা লোড করুন
আমাদের এখন leaderboard নামক একটি ডাটাবেস আছে যেখানে দুটি টেবিল রয়েছে; Players এবং Scores । এখন আসুন Go ক্লায়েন্ট লাইব্রেরি ব্যবহার করি প্লেয়ারের সাথে আমাদের Players টেবিল এবং প্রতিটি প্লেয়ারের জন্য র্যান্ডম স্কোর সহ আমাদের Scores টেবিল।
যদি এটি ইতিমধ্যে খোলা না থাকে, নীচে হাইলাইট করা আইকনে ক্লিক করে ক্লাউড শেল সম্পাদক খুলুন:
এরপরে, ক্লাউড শেল এডিটরে leaderboard.go ফাইলটি সম্পাদনা করুন একটি insertplayers কমান্ড যোগ করতে যা Players টেবিলে 100 জন খেলোয়াড় সন্নিবেশ করতে ব্যবহার করা যেতে পারে। আমরা একটি insertscores কমান্ড যোগ করব যা Players টেবিলের প্রতিটি খেলোয়াড়ের জন্য Scores টেবিলে 4টি র্যান্ডম স্কোর সন্নিবেশ করতে ব্যবহার করা যেতে পারে।
প্রথমে leaderboard.go ফাইলের শীর্ষে imports বিভাগটি আপডেট করুন, বর্তমানে সেখানে যা আছে তা প্রতিস্থাপন করুন যাতে আপনার কাজ শেষ হয়ে গেলে এটি নিম্নলিখিতগুলির মতো দেখায়:
import (
"context"
"flag"
"fmt"
"io"
"log"
"math/rand"
"os"
"regexp"
"time"
"cloud.google.com/go/spanner"
database "cloud.google.com/go/spanner/admin/database/apiv1"
"google.golang.org/api/iterator"
adminpb "google.golang.org/genproto/googleapis/spanner/admin/database/v1"
)
তারপরে ফাইলের শীর্ষে কমান্ডের একটি তালিকা সহ একটি নতুন কমান্ড টাইপ যোগ করুন, "টাইপ অ্যাডমিনকমান্ড ..." দিয়ে শুরু হওয়া লাইনের ঠিক নীচে যাতে আপনার কাজ শেষ হয়ে গেলে এটি নিম্নলিখিতগুলির মতো দেখায়:
type adminCommand func(ctx context.Context, w io.Writer, adminClient *database.DatabaseAdminClient, database string) error
type command func(ctx context.Context, w io.Writer, client *spanner.Client) error
var (
commands = map[string]command{
"insertplayers": insertPlayers,
"insertscores": insertScores,
}
)
পরবর্তীতে নিম্নলিখিত insertPlayers যোগ করুন, এবং বিদ্যমান createdatabase() ফাংশনের নীচে স্কোর ফাংশন সন্নিবেশ করুন:
func insertPlayers(ctx context.Context, w io.Writer, client *spanner.Client) error {
// Get number of players to use as an incrementing value for each PlayerName to be inserted
stmt := spanner.Statement{
SQL: `SELECT Count(PlayerId) as PlayerCount FROM Players`,
}
iter := client.Single().Query(ctx, stmt)
defer iter.Stop()
row, err := iter.Next()
if err != nil {
return err
}
var numberOfPlayers int64 = 0
if err := row.Columns(&numberOfPlayers); err != nil {
return err
}
// Initialize values for random PlayerId
rand.Seed(time.Now().UnixNano())
min := 1000000000
max := 9000000000
// Insert 100 player records into the Players table
_, err = client.ReadWriteTransaction(ctx, func(ctx context.Context, txn *spanner.ReadWriteTransaction) error {
stmts := []spanner.Statement{}
for i := 1; i <= 100; i++ {
numberOfPlayers++
playerID := rand.Intn(max-min) + min
playerName := fmt.Sprintf("Player %d", numberOfPlayers)
stmts = append(stmts, spanner.Statement{
SQL: `INSERT INTO Players
(PlayerId, PlayerName)
VALUES (@playerID, @playerName)`,
Params: map[string]interface{}{
"playerID": playerID,
"playerName": playerName,
},
})
}
_, err := txn.BatchUpdate(ctx, stmts)
if err != nil {
return err
}
return nil
})
fmt.Fprintf(w, "Inserted players \n")
return nil
}
func insertScores(ctx context.Context, w io.Writer, client *spanner.Client) error {
playerRecordsFound := false
// Create slice for insert statements
stmts := []spanner.Statement{}
// Select all player records
stmt := spanner.Statement{SQL: `SELECT PlayerId FROM Players`}
iter := client.Single().Query(ctx, stmt)
defer iter.Stop()
// Insert 4 score records into the Scores table for each player in the Players table
for {
row, err := iter.Next()
if err == iterator.Done {
break
}
if err != nil {
return err
}
playerRecordsFound = true
var playerID int64
if err := row.ColumnByName("PlayerId", &playerID); err != nil {
return err
}
// Initialize values for random score and date
rand.Seed(time.Now().UnixNano())
min := 1000
max := 1000000
for i := 0; i < 4; i++ {
// Generate random score between 1,000 and 1,000,000
score := rand.Intn(max-min) + min
// Generate random day within the past two years
now := time.Now()
endDate := now.Unix()
past := now.AddDate(0, -24, 0)
startDate := past.Unix()
randomDateInSeconds := rand.Int63n(endDate-startDate) + startDate
randomDate := time.Unix(randomDateInSeconds, 0)
// Add insert statement to stmts slice
stmts = append(stmts, spanner.Statement{
SQL: `INSERT INTO Scores
(PlayerId, Score, Timestamp)
VALUES (@playerID, @score, @timestamp)`,
Params: map[string]interface{}{
"playerID": playerID,
"score": score,
"timestamp": randomDate,
},
})
}
}
if !playerRecordsFound {
fmt.Fprintln(w, "No player records currently exist. First insert players then insert scores.")
} else {
_, err := client.ReadWriteTransaction(ctx, func(ctx context.Context, txn *spanner.ReadWriteTransaction) error {
// Commit insert statements for all scores to be inserted as a single transaction
_, err := txn.BatchUpdate(ctx, stmts)
return err
})
if err != nil {
return err
}
fmt.Fprintln(w, "Inserted scores")
}
return nil
}
তারপর, insert কমান্ডটিকে কার্যকরী করতে, return nil বিবৃতিটি প্রতিস্থাপন করে, createdatabase হ্যান্ডলিং স্টেটমেন্টের নীচে আপনার অ্যাপ্লিকেশনের "রান" ফাংশনে নিম্নলিখিত কোডটি যুক্ত করুন:
// insert and query commands
cmdFn := commands[cmd]
if cmdFn == nil {
flag.Usage()
os.Exit(2)
}
err := cmdFn(ctx, w, dataClient)
if err != nil {
fmt.Fprintf(w, "%s failed with %v", cmd, err)
}
return err
একবার আপনি run ফাংশনটি সম্পন্ন করার পরে নিম্নলিখিতটির মতো হওয়া উচিত:
func run(ctx context.Context, adminClient *database.DatabaseAdminClient, dataClient *spanner.Client, w io.Writer,
cmd string, db string, timespan int) error {
// createdatabase command
if cmd == "createdatabase" {
err := createDatabase(ctx, w, adminClient, db)
if err != nil {
fmt.Fprintf(w, "%s failed with %v", cmd, err)
}
return err
}
// insert and query commands
cmdFn := commands[cmd]
if cmdFn == nil {
flag.Usage()
os.Exit(2)
}
err := cmdFn(ctx, w, dataClient)
if err != nil {
fmt.Fprintf(w, "%s failed with %v", cmd, err)
}
return err
}
আপনার অ্যাপ্লিকেশানে "ইনসার্ট" কার্যকারিতা যোগ করা সম্পূর্ণ করার চূড়ান্ত ধাপ হল flag.Usage() ফাংশনে "insertplayers" এবং "insertscores" কমান্ডের জন্য সহায়তা পাঠ্য যোগ করা। সন্নিবেশ কমান্ডের জন্য সহায়তা পাঠ্য অন্তর্ভুক্ত করতে flag.Usage() ফাংশনে নিম্নলিখিত সহায়তা পাঠ্য যোগ করুন:
সম্ভাব্য কমান্ডের তালিকায় দুটি কমান্ড যোগ করুন:
Command can be one of: createdatabase, insertplayers, insertscores
এবং createdatabase কমান্ডের জন্য হেল্প টেক্সটের নিচে এই অতিরিক্ত হেল্প টেক্সট যোগ করুন।
leaderboard insertplayers projects/my-project/instances/my-instance/databases/example-db
- Insert 100 sample Player records into the database.
leaderboard insertscores projects/my-project/instances/my-instance/databases/example-db
- Insert sample score data into Scores sample Cloud Spanner database table.
ক্লাউড শেল এডিটরের "ফাইল" মেনুর অধীনে "সংরক্ষণ করুন" নির্বাচন করে leaderboard.go ফাইলে আপনার করা পরিবর্তনগুলি সংরক্ষণ করুন৷
আপনি insertplayers এবং insertscores কমান্ডগুলি সক্রিয় করতে কোড যুক্ত করার পরে আপনার leaderboard.go ফাইলটি কীভাবে দেখা উচিত তার একটি উদাহরণ দেখতে golang-samples/spanner/spanner_leaderboard ডিরেক্টরির মধ্যে leaderboard.go ফাইলটি ব্যবহার করতে পারেন৷
এখন নতুন insertplayers এবং insertscores কমান্ডগুলি অ্যাপ্লিকেশনের সম্ভাব্য কমান্ডের তালিকায় অন্তর্ভুক্ত করা হয়েছে তা নিশ্চিত করতে অ্যাপ্লিকেশনটি তৈরি এবং চালান। অ্যাপ্লিকেশনটি তৈরি করতে নিম্নলিখিত কমান্ডটি চালান:
go build leaderboard.go
নিম্নলিখিত কমান্ডটি প্রবেশ করে ক্লাউড শেলটিতে ফলস্বরূপ অ্যাপ্লিকেশনটি চালান:
./leaderboard
আপনি এখন অ্যাপ্লিকেশনের ডিফল্ট আউটপুটে অন্তর্ভুক্ত insertplayers এবং insertscores কমান্ড দেখতে হবে:
Usage: leaderboard <command> <database_name> [command_option]
Command can be one of: createdatabase, insertplayers, insertscores
Examples:
leaderboard createdatabase projects/my-project/instances/my-instance/databases/example-db
- Create a sample Cloud Spanner database along with sample tables in your project.
leaderboard insertplayers projects/my-project/instances/my-instance/databases/example-db
- Insert 100 sample Player records into the database.
leaderboard insertscores projects/my-project/instances/my-instance/databases/example-db
- Insert sample score data into Scores sample Cloud Spanner database table.
এখন insertplayers কমান্ডটি একই আর্গুমেন্ট মান দিয়ে রান করা যাক যখন আমরা createdatabase কমান্ড বলেছিলাম। নিশ্চিত করুন যে আপনি এই কোডল্যাবের শুরুতে তৈরি করা প্রজেক্ট আইডি দিয়ে my-project প্রতিস্থাপন করেছেন।
./leaderboard insertplayers projects/my-project/instances/cloudspanner-leaderboard/databases/leaderboard
কয়েক সেকেন্ড পরে আপনি নিম্নলিখিত মত একটি প্রতিক্রিয়া দেখতে হবে:
Inserted players
এখন Players টেবিলের প্রতিটি খেলোয়াড়ের জন্য টাইমস্ট্যাম্প সহ চারটি র্যান্ডম স্কোর সহ আমাদের Scores টেবিলটি পূরণ করতে Go ক্লায়েন্ট লাইব্রেরি ব্যবহার করা যাক।
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 অপারেশনগুলির জন্য সঠিক লেনদেন টাইমস্ট্যাম্প সহ স্বয়ংক্রিয়ভাবে জনবহুল হতে সক্ষম করে৷
আপনি একটি "কমিট টাইমস্ট্যাম্প" কলামে আপনার নিজস্ব টাইমস্ট্যাম্প মান সন্নিবেশ করতে পারেন যতক্ষণ না আপনি অতীতের একটি মান সহ একটি টাইমস্ট্যাম্প সন্নিবেশ করান, যা আমরা এই কোডল্যাবের উদ্দেশ্যে করব৷
এখন insertplayers কমান্ড কল করার সময় আমরা একই আর্গুমেন্ট মান দিয়ে insertscores কমান্ডটি চালাই। নিশ্চিত করুন যে আপনি এই কোডল্যাবের শুরুতে তৈরি করা প্রজেক্ট আইডি দিয়ে my-project প্রতিস্থাপন করেছেন।
./leaderboard insertscores projects/my-project/instances/cloudspanner-leaderboard/databases/leaderboard
কয়েক সেকেন্ড পরে আপনি নিম্নলিখিত মত একটি প্রতিক্রিয়া দেখতে হবে:
Inserted scores
insertScores ফাংশন চালানোর ফলে অতীতে ঘটে যাওয়া তারিখ-সময়ের সাথে এলোমেলোভাবে তৈরি করা টাইমস্ট্যাম্প সন্নিবেশ করতে নিম্নলিখিত কোড স্নিপেট ব্যবহার করা হয়:
now := time.Now()
endDate := now.Unix()
past := now.AddDate(0, -24, 0)
startDate := past.Unix()
randomDateInSeconds := rand.Int63n(endDate-startDate) + startDate
randomDate := time.Unix(randomDateInSeconds, 0)
stmts = append(stmts, spanner.Statement{
SQL: `INSERT INTO Scores
(PlayerId, Score, Timestamp)
VALUES (@playerID, @score, @timestamp)`,
Params: map[string]interface{}{
"playerID": playerID,
"score": score,
"timestamp": randomDate,
},
})
Timestamp কলামে টাইমস্ট্যাম্পের সাথে স্বয়ংক্রিয়ভাবে "সন্নিবেশ" লেনদেন যখন সংঘটিত হয় তখন আপনি গো কনস্ট্যান্ট spanner.CommitTimestamp সন্নিবেশ করতে পারেন। নিচের কোড স্নিপেটের মতো কমিটটাইমস্ট্যাম্প:
...
stmts = append(stmts, spanner.Statement{
SQL: `INSERT INTO Scores
(PlayerId, Score, Timestamp)
VALUES (@playerID, @score, @timestamp)`,
Params: map[string]interface{}{
"playerID": playerID,
"score": score,
"timestamp": spanner.CommitTimestamp,
},
})
এখন যেহেতু আমরা ডেটা লোডিং সম্পন্ন করেছি, আসুন ক্লাউড কনসোলের ক্লাউড স্প্যানার বিভাগে আমাদের নতুন টেবিলে যে মানগুলি লিখেছি তা যাচাই করা যাক৷ প্রথমে leaderboard ডাটাবেস নির্বাচন করুন এবং তারপর Players টেবিল নির্বাচন করুন। Data ট্যাবে ক্লিক করুন। আপনি দেখতে পাবেন যে আপনার টেবিলের PlayerId এবং PlayerName কলামে ডেটা আছে।
এর পরে, Scores টেবিলে ক্লিক করে এবং Data ট্যাব নির্বাচন করে স্কোর টেবিলে ডেটা আছে তা যাচাই করা যাক। টেবিলের PlayerId , Timestamp এবং Score কলামে আপনার ডেটা আছে তা দেখতে হবে।
ভালো হয়েছে! আসুন কিছু প্রশ্ন চালানোর জন্য আমাদের অ্যাপ আপডেট করি যা আমরা একটি গেমিং লিডারবোর্ড তৈরি করতে ব্যবহার করতে পারি।
6. লিডারবোর্ড কোয়েরি চালান
এখন যেহেতু আমরা আমাদের ডাটাবেস সেট আপ করেছি এবং আমাদের টেবিলে তথ্য লোড করেছি, আসুন এই ডেটা ব্যবহার করে একটি লিডারবোর্ড তৈরি করি। এটি করার জন্য আমাদের নিম্নলিখিত চারটি প্রশ্নের উত্তর দিতে হবে:
- কোন খেলোয়াড় সর্বকালের "শীর্ষ দশ"?
- কোন খেলোয়াড় বছরের "শীর্ষ দশ"?
- কোন খেলোয়াড় মাসের "শীর্ষ দশ"?
- কোন খেলোয়াড় সপ্তাহের "শীর্ষ দশ"?
এসকিউএল কোয়েরি চালানোর জন্য আমাদের অ্যাপ্লিকেশন আপডেট করা যাক যা এই প্রশ্নের উত্তর দেবে।
আমরা একটি query কমান্ড এবং একটি queryWithTimespan কমান্ড যোগ করব যা আমাদের লিডারবোর্ডের জন্য প্রয়োজনীয় তথ্য তৈরি করবে এমন প্রশ্নের উত্তর দেওয়ার জন্য প্রশ্নগুলি চালানোর একটি উপায় প্রদান করবে।
একটি query কমান্ড এবং একটি queryWithTimespan কমান্ড যোগ করতে অ্যাপ্লিকেশনটি আপডেট করতে ক্লাউড শেল এডিটরে leaderboard.go ফাইলটি সম্পাদনা করুন৷ কমা দিয়ে আমাদের স্কোর ফরম্যাট করতে আমরা একটি formatWithCommas হেল্পার ফাংশন যোগ করব।
প্রথমে leaderboard.go ফাইলের শীর্ষে imports বিভাগটি আপডেট করুন, বর্তমানে সেখানে যা আছে তা প্রতিস্থাপন করুন যাতে আপনার কাজ শেষ হয়ে গেলে এটি নিম্নলিখিতগুলির মতো দেখায়:
import (
"bytes"
"context"
"flag"
"fmt"
"io"
"log"
"math/rand"
"os"
"regexp"
"strconv"
"time"
"cloud.google.com/go/spanner"
database "cloud.google.com/go/spanner/admin/database/apiv1"
"google.golang.org/api/iterator"
adminpb "google.golang.org/genproto/googleapis/spanner/admin/database/v1"
)
পরবর্তীতে বিদ্যমান insertScores পদ্ধতির নীচে নিম্নলিখিত দুটি ফাংশন এবং সহায়ক ফাংশন যোগ করুন:
func query(ctx context.Context, w io.Writer, client *spanner.Client) error {
stmt := spanner.Statement{
SQL: `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`}
iter := client.Single().Query(ctx, stmt)
defer iter.Stop()
for {
row, err := iter.Next()
if err == iterator.Done {
return nil
}
if err != nil {
return err
}
var playerID, score int64
var playerName string
var timestamp time.Time
if err := row.Columns(&playerID, &playerName, &score, ×tamp); err != nil {
return err
}
fmt.Fprintf(w, "PlayerId: %d PlayerName: %s Score: %s Timestamp: %s\n",
playerID, playerName, formatWithCommas(score), timestamp.String()[0:10])
}
}
func queryWithTimespan(ctx context.Context, w io.Writer, client *spanner.Client, timespan int) error {
stmt := spanner.Statement{
SQL: `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`,
Params: map[string]interface{}{"Timespan": timespan},
}
iter := client.Single().Query(ctx, stmt)
defer iter.Stop()
for {
row, err := iter.Next()
if err == iterator.Done {
return nil
}
if err != nil {
return err
}
var playerID, score int64
var playerName string
var timestamp time.Time
if err := row.Columns(&playerID, &playerName, &score, ×tamp); err != nil {
return err
}
fmt.Fprintf(w, "PlayerId: %d PlayerName: %s Score: %s Timestamp: %s\n",
playerID, playerName, formatWithCommas(score), timestamp.String()[0:10])
}
}
func formatWithCommas(n int64) string {
numberAsString := strconv.FormatInt(n, 10)
numberLength := len(numberAsString)
if numberLength < 4 {
return numberAsString
}
var buffer bytes.Buffer
comma := []rune(",")
bufferPosition := numberLength % 3
if (bufferPosition) > 0 {
bufferPosition = 3 - bufferPosition
}
for i := 0; i < numberLength; i++ {
if bufferPosition == 3 {
buffer.WriteRune(comma[0])
bufferPosition = 0
}
bufferPosition++
buffer.WriteByte(numberAsString[i])
}
return buffer.String()
}
leaderboard.go ফাইলের উপরের দিকের commands ভেরিয়েবলে একটি কমান্ড অপশন হিসেবে "query" যোগ করুন, " insertscores": insertScores অপশনের ঠিক নিচে যাতে commands ভেরিয়েবলটি এরকম দেখায়:
var (
commands = map[string]command{
"insertplayers": insertPlayers,
"insertscores": insertScores,
"query": query,
}
)
এরপর run ফাংশনের মধ্যে কমান্ড অপশন হিসেবে "queryWithTimespan" যোগ করুন, "createdatabase" কমান্ড সেকশনের নিচে এবং "insert and query" কমান্ড হ্যান্ডলিং সেকশনের উপরে:
// querywithtimespan command
if cmd == "querywithtimespan" {
err := queryWithTimespan(ctx, w, dataClient, timespan)
if err != nil {
fmt.Fprintf(w, "%s failed with %v", cmd, err)
}
return err
}
একবার আপনি run ফাংশনটি সম্পন্ন করার পরে নিম্নলিখিতটির মতো হওয়া উচিত:
func run(ctx context.Context, adminClient *database.DatabaseAdminClient, dataClient *spanner.Client, w io.Writer,
cmd string, db string, timespan int) error {
// createdatabase command
if cmd == "createdatabase" {
err := createDatabase(ctx, w, adminClient, db)
if err != nil {
fmt.Fprintf(w, "%s failed with %v", cmd, err)
}
return err
}
// querywithtimespan command
if cmd == "querywithtimespan" {
if timespan == 0 {
flag.Usage()
os.Exit(2)
}
err := queryWithTimespan(ctx, w, dataClient, timespan)
if err != nil {
fmt.Fprintf(w, "%s failed with %v", cmd, err)
}
return err
}
// insert and query commands
cmdFn := commands[cmd]
if cmdFn == nil {
flag.Usage()
os.Exit(2)
}
err := cmdFn(ctx, w, dataClient)
if err != nil {
fmt.Fprintf(w, "%s failed with %v", cmd, err)
}
return err
}
তারপর, queryWithTimespan কমান্ডটিকে কার্যকরী করতে, আপনার অ্যাপ্লিকেশনের "প্রধান" পদ্ধতিতে flag.Parse() কোড ব্লকটি আপডেট করুন যাতে এটি নিম্নলিখিতগুলির মতো দেখায়:
flag.Parse()
flagCount := len(flag.Args())
if flagCount < 2 || flagCount > 3 {
flag.Usage()
os.Exit(2)
}
cmd, db := flag.Arg(0), flag.Arg(1)
// If query timespan flag is specified, parse to int
var timespan int = 0
if flagCount == 3 {
parsedTimespan, err := strconv.Atoi(flag.Arg(2))
if err != nil {
fmt.Println(err)
os.Exit(2)
}
timespan = parsedTimespan
}
ctx, cancel := context.WithTimeout(context.Background(), 1*time.Minute)
defer cancel()
adminClient, dataClient := createClients(ctx, db)
if err := run(ctx, adminClient, dataClient, os.Stdout, cmd, db, timespan); err != nil {
os.Exit(1)
}
আপনার অ্যাপ্লিকেশনে "কোয়েরি" কার্যকারিতা যোগ করা সম্পূর্ণ করার চূড়ান্ত পদক্ষেপ হল flag.Usage() ফাংশনে "query" এবং "querywithtimespan" কমান্ডের জন্য সহায়তা পাঠ্য যোগ করা। ক্যোয়ারী কমান্ডের জন্য হেল্প টেক্সট অন্তর্ভুক্ত করতে flag.Usage() ফাংশনে কোডের নিম্নলিখিত লাইন যোগ করুন:
সম্ভাব্য কমান্ডের তালিকায় দুটি "কোয়েরি" কমান্ড যোগ করুন:
Command can be one of: createdatabase, insertplayers, insertscores, query, querywithtimespan
এবং insertscores কমান্ডের জন্য সাহায্য পাঠ্যের নীচে এই অতিরিক্ত সহায়তা পাঠ্যটি যুক্ত করুন।
leaderboard query projects/my-project/instances/my-instance/databases/example-db
- Query players with top ten scores of all time.
leaderboard querywithtimespan projects/my-project/instances/my-instance/databases/example-db 168
- Query players with top ten scores within a timespan specified in hours.
ক্লাউড শেল এডিটরের "ফাইল" মেনুর অধীনে "সংরক্ষণ করুন" নির্বাচন করে leaderboard.go ফাইলে আপনার করা পরিবর্তনগুলি সংরক্ষণ করুন৷
আপনি query এবং querywithtimespan কমান্ডগুলি সক্ষম করার জন্য কোড যোগ করার পরে আপনার leaderboard.go ফাইলটি কীভাবে দেখা উচিত তার একটি উদাহরণ দেখতে golang-samples/spanner/spanner_leaderboard ডিরেক্টরির মধ্যে leaderboard.go ফাইলটি ব্যবহার করতে পারেন৷
এখন নতুন query এবং querywithtimespan কমান্ডগুলি অ্যাপলিকেশনের সম্ভাব্য কমান্ডের তালিকায় অন্তর্ভুক্ত করা হয়েছে তা নিশ্চিত করতে অ্যাপ্লিকেশনটি তৈরি এবং চালান।
অ্যাপ্লিকেশনটি তৈরি করতে ক্লাউড শেলে নিম্নলিখিত কমান্ডটি চালান:
go build leaderboard.go
নিম্নলিখিত কমান্ডটি প্রবেশ করে ক্লাউড শেলটিতে ফলস্বরূপ অ্যাপ্লিকেশনটি চালান:
./leaderboard
আপনি এখন একটি নতুন কমান্ড বিকল্প হিসাবে অ্যাপের ডিফল্ট আউটপুটে অন্তর্ভুক্ত timespan কমান্ডের সাথে query এবং querywithtimespan দেখতে পাবেন:
Usage: leaderboard <command> <database_name> [command_option]
Command can be one of: createdatabase, insertplayers, insertscores, query, querywithtimespan
Examples:
leaderboard createdatabase projects/my-project/instances/my-instance/databases/example-db
- Create a sample Cloud Spanner database along with sample tables in your project.
leaderboard insertplayers projects/my-project/instances/my-instance/databases/example-db
- Insert 100 sample Player records into the database.
leaderboard insertscores projects/my-project/instances/my-instance/databases/example-db
- Insert sample score data into Scores sample Cloud Spanner database table.
leaderboard query projects/my-project/instances/my-instance/databases/example-db
- Query players with top ten scores of all time.
leaderboard querywithtimespan projects/my-project/instances/my-instance/databases/example-db 168
- Query players with top ten scores within a timespan specified in hours.
আপনি প্রতিক্রিয়া থেকে দেখতে পাচ্ছেন যে আমরা আমাদের সর্বকালের "শীর্ষ দশ" খেলোয়াড়ের তালিকা পেতে query কমান্ড ব্যবহার করতে পারি। আমরা আরও দেখতে পারি যে querywithtimespan কমান্ড আমাদের Scores টেবিলের Timestamp কলামে তাদের মানের উপর ভিত্তি করে রেকর্ড ফিল্টার করার জন্য ব্যবহার করার জন্য ঘন্টার সংখ্যার মধ্যে একটি সময়কাল নির্দিষ্ট করতে দেয়।
create কমান্ড চালানোর সময় আমরা একই আর্গুমেন্ট মান ব্যবহার করে query কমান্ড রান করি। নিশ্চিত করুন যে আপনি এই কোডল্যাবের শুরুতে তৈরি করা প্রজেক্ট আইডি দিয়ে my-project প্রতিস্থাপন করেছেন।
./leaderboard query projects/my-project/instances/cloudspanner-leaderboard/databases/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
এখন querywithtimespan কমান্ডটি চালাই প্রয়োজনীয় আর্গুমেন্ট সহ বছরের "শীর্ষ দশ" খেলোয়াড়কে জিজ্ঞাসা করার জন্য একটি "টাইমস্প্যান" নির্দিষ্ট করে একটি বছরে ঘন্টার সংখ্যার সমান যা 8760। নিশ্চিত করুন যে আপনি my-project প্রকল্পের সাথে প্রতিস্থাপন করেছেন। এই কোডল্যাবের শুরুতে আপনার তৈরি করা আইডি।
./leaderboard querywithtimespan projects/my-project/instances/cloudspanner-leaderboard/databases/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
এখন querywithtimespan কমান্ডটি চালানো যাক মাসের "শীর্ষ দশ" প্লেয়ারকে জিজ্ঞাসা করার জন্য একটি "টাইমস্প্যান" নির্দিষ্ট করে একটি মাসে ঘন্টার সংখ্যা যা 730 এর সমান । নিশ্চিত করুন যে আপনি my-project আপনার তৈরি করা প্রজেক্ট আইডি দিয়ে প্রতিস্থাপন করেছেন। এই কোডল্যাবের শুরু।
./leaderboard querywithtimespan projects/my-project/instances/cloudspanner-leaderboard/databases/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
এখন querywithtimespan কমান্ডটি চালানো যাক সপ্তাহের "শীর্ষ দশ" প্লেয়ারকে জিজ্ঞাসা করার জন্য একটি "টাইমস্প্যান" নির্দিষ্ট করে সপ্তাহে ঘন্টার সংখ্যার সমান যা 168। নিশ্চিত করুন যে আপনি my-project আপনার তৈরি করা প্রজেক্ট আইডি দিয়ে প্রতিস্থাপন করেছেন। এই কোডল্যাবের শুরু।
./leaderboard querywithtimespan projects/my-project/instances/cloudspanner-leaderboard/databases/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
চমৎকার কাজ!
এখন আপনি রেকর্ড যোগ করার সাথে সাথে ক্লাউড স্প্যানার আপনার ডাটাবেসকে যত বড় হতে হবে ততই স্কেল করবে। আপনার ডাটাবেস যতই বাড়ুক না কেন, আপনার গেমের লিডারবোর্ড ক্লাউড স্প্যানার এবং এর ট্রুটাইম প্রযুক্তির সাথে নির্ভুলতার সাথে স্কেল করা চালিয়ে যেতে পারে।
7. পরিষ্কার করা
স্প্যানারের সাথে মজা করার পরে আমাদের খেলার মাঠ পরিষ্কার করতে হবে, মূল্যবান সম্পদ এবং অর্থ বাঁচাতে হবে। ভাগ্যক্রমে এটি একটি সহজ পদক্ষেপ, শুধু ক্লাউড কনসোলের ক্লাউড স্প্যানার বিভাগে যান এবং "ক্লাউড স্প্যানার ইনস্ট্যান্স সেটআপ করুন" নামের কোডল্যাব ধাপে আমরা যে উদাহরণটি তৈরি করেছি তা মুছে ফেলুন।
8. অভিনন্দন!
আমরা যা কভার করেছি:
- লিডারবোর্ডের জন্য Google ক্লাউড স্প্যানার ইনস্ট্যান্স, ডেটাবেস এবং টেবিল স্কিমা
- কীভাবে গো কনসোল অ্যাপ্লিকেশন তৈরি করবেন
- গো ক্লায়েন্ট লাইব্রেরি ব্যবহার করে কীভাবে একটি স্প্যানার ডেটাবেস এবং টেবিল তৈরি করবেন
- গো ক্লায়েন্ট লাইব্রেরি ব্যবহার করে একটি স্প্যানার ডাটাবেসে কীভাবে ডেটা লোড করবেন
- স্প্যানার কমিট টাইমস্ট্যাম্প এবং গো ক্লায়েন্ট লাইব্রেরি ব্যবহার করে কীভাবে আপনার ডেটা থেকে "শীর্ষ দশ" ফলাফল অনুসন্ধান করবেন
পরবর্তী পদক্ষেপ:
- স্প্যানার ক্যাপ হোয়াইটপেপার পড়ুন
- স্কিমা ডিজাইন এবং কোয়েরি সেরা অনুশীলন সম্পর্কে জানুন
- ক্লাউড স্প্যানার কমিট টাইমস্ট্যাম্প সম্পর্কে আরও জানুন
আমাদের আপনার মতামত দিন
- আমাদের খুব সংক্ষিপ্ত সমীক্ষা সম্পূর্ণ করার জন্য একটু সময় নিন