Cloud Spanner: Java की मदद से गेमिंग लीडरबोर्ड बनाएं

1. खास जानकारी

Google Cloud Spanner, पूरी तरह से मैनेज की गई हॉरिज़ॉन्टल तौर पर बढ़ाने वाली, दुनिया भर में डिस्ट्रिब्यूट की जाने वाली, रिलेशनल डेटाबेस सेवा है. यह परफ़ॉर्मेंस और ज़्यादा उपलब्धता को छोड़े बिना, ACID लेन-देन और SQL सिमैंटिक उपलब्ध कराती है.

इस लैब में, आपको Cloud Spanner इंस्टेंस को सेटअप करने का तरीका बताया जाएगा. आपको ऐसा डेटाबेस और स्कीमा बनाने का तरीका बताया जाएगा जिसका इस्तेमाल गेमिंग लीडरबोर्ड के लिए किया जा सकता है. सबसे पहले आपको एक प्लेयर टेबल बनानी होगी, जिसमें खिलाड़ी की जानकारी सेव की जा सकती है. साथ ही, खिलाड़ी के स्कोर को स्टोर करने के लिए एक स्कोर टेबल बनाई जाती है.

इसके बाद, टेबल में सैंपल डेटा का इस्तेमाल होगा. इसके बाद, टॉप 10 सैंपल क्वेरी चलाकर और आखिर में संसाधनों को खाली करने के लिए, इंस्टेंस को मिटाकर लैब को खत्म करें.

आपको इनके बारे में जानकारी मिलेगी

  • Cloud Spanner इंस्टेंस सेट अप करने का तरीका.
  • डेटाबेस और टेबल बनाने का तरीका.
  • कमिट टाइमस्टैंप कॉलम को इस्तेमाल करने का तरीका.
  • टाइमस्टैंप की मदद से, Cloud Spanner की डेटाबेस टेबल में डेटा लोड करने का तरीका.
  • अपने क्लाउड स्पैनर डेटाबेस के लिए क्वेरी कैसे करें.
  • Cloud Spanner इंस्टेंस मिटाने का तरीका.

आपको इन चीज़ों की ज़रूरत होगी

  • कोई वेब ब्राउज़र, जैसे कि Chrome या Firefox.

इस ट्यूटोरियल का इस्तेमाल कैसे किया जाएगा?

इसे सिर्फ़ पढ़ें इसे पढ़ें और कसरतों को पूरा करें

Google Cloud Platform के साथ अपने अनुभव को कैसे रेटिंग दें?

शुरुआती इंटरमीडिएट कुशल

2. सेटअप और ज़रूरी शर्तें

अपने हिसाब से एनवायरमेंट सेटअप करना

अगर आपके पास पहले से Google खाता (Gmail या Google Apps) नहीं है, तो आपको एक खाता बनाना होगा. Google Cloud Platform कंसोल ( console.cloud.google.com) में साइन इन करें और एक नया प्रोजेक्ट बनाएं.

अगर आपके पास पहले से कोई प्रोजेक्ट है, तो कंसोल के ऊपर बाईं ओर मौजूद, प्रोजेक्ट चुनने के लिए पुल डाउन मेन्यू पर क्लिक करें:

6c9406d9b014760.png

और 'नया प्रोजेक्ट' पर क्लिक करें बटन:

f708315ae07353d0.png

अगर आपके पास पहले से कोई प्रोजेक्ट नहीं है, तो आपको अपना पहला प्रोजेक्ट बनाने के लिए, इस तरह का डायलॉग बॉक्स दिखेगा:

870a3cbd6541ee86.png

इसके बाद, प्रोजेक्ट बनाने वाले डायलॉग बॉक्स की मदद से अपने नए प्रोजेक्ट की जानकारी डाली जा सकती है:

6a92c57d3250a4b3.png

वह प्रोजेक्ट आईडी याद रखें जो Google Cloud के सभी प्रोजेक्ट के लिए एक यूनीक नाम होता है. ऊपर दिया गया नाम पहले ही किसी दूसरे प्रोजेक्ट के लिए इस्तेमाल किया जा चुका है. इसलिए, यह आपके लिए काम नहीं करेगा! बाद में, इस कोडलैब को इस कोडलैब में PROJECT_ID के तौर पर दिखाया जाएगा.

इसके बाद, अगर आपने पहले से ऐसा नहीं किया है, तो आपको Google Cloud के संसाधनों का इस्तेमाल करने के लिए, Developers Console में बिलिंग चालू करनी होगी. साथ ही, Cloud Spanner API को चालू करना होगा.

15d0ef27a8fब27.png

इस कोडलैब को आज़माने के लिए आपको कुछ डॉलर से ज़्यादा खर्च नहीं करना चाहिए. हालांकि, अगर आप ज़्यादा संसाधनों का इस्तेमाल करने का फ़ैसला करते हैं या उन्हें बंद कर देते हैं, तो यह ज़्यादा हो सकता है (इस दस्तावेज़ के आखिर में "क्लीनअप" सेक्शन देखें). Google Cloud Spanner की कीमत की जानकारी यहां दी गई है.

Google Cloud Platform के नए उपयोगकर्ता 300 डॉलर के मुफ़्त में आज़माने की ज़रूरी शर्तें पूरी करते हैं. इसके तहत, कोडलैब का यह वर्शन बिना किसी शुल्क के इस्तेमाल किया जा सकता है.

Google Cloud Shell का सेटअप

Google Cloud और Spanner को आपके लैपटॉप से कहीं से भी ऑपरेट किया जा सकता है. हालांकि, इस कोडलैब में हम Google Cloud Shell का इस्तेमाल करेंगे. यह क्लाउड में चलने वाला कमांड लाइन एनवायरमेंट है.

Debian आधारित इस वर्चुअल मशीन में ऐसे सभी डेवलपमेंट टूल मौजूद हैं जिनकी आपको ज़रूरत पड़ेगी. यह पांच जीबी की स्थायी होम डायरेक्ट्री उपलब्ध कराता है और Google Cloud में चलता है. इससे नेटवर्क की परफ़ॉर्मेंस और पुष्टि करने की प्रक्रिया को बेहतर बनाने में मदद मिलती है. इसका मतलब है कि इस कोडलैब के लिए आपको सिर्फ़ एक ब्राउज़र की ज़रूरत होगी. हां, यह Chromebook पर काम करता है.

  1. Cloud Console से Cloud Shell को चालू करने के लिए, Cloud Shell को चालू करें gcLMt5IuEcJJNnMId-Bcz3sxCd0rZn7IzT_r95C8UZeqML68Y1efBG_B0VRp7hc7qiZTLAF-TXD7SsOadxn8uadgHhaLeASnVS3ZHK39eOlKJOgj9SJua_oeGhMxRrbOg3qigddS2A पर क्लिक करें. प्रावधान करने और एनवायरमेंट से कनेक्ट होने में कुछ ही समय लगेगा.

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

14-06-2017 को 10.13.43 PM.png पर स्क्रीन शॉट लिया गया

Cloud Shell से कनेक्ट करने के बाद, आपको दिखेगा कि आपकी पुष्टि पहले ही हो चुकी है. साथ ही, यह प्रोजेक्ट पहले से ही आपके 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 चाहिए? देखें कि आपने सेटअप के चरणों में किस आईडी का इस्तेमाल किया है या इसे Cloud Console के डैशबोर्ड में देखें:

158fNPfwSxsFqz9YbtJVZes8viTS3d1bV4CVhij3XPxuzVFOtTObnwsphlm6lYGmgdMFwBJtc-FaLrZU7XHAg_ZYoCrgombMRR3h-eolLPcvO351c5iBv506B3ZwghZoiRg6cz23Qw

Cloud Shell, डिफ़ॉल्ट रूप से कुछ एनवायरमेंट वैरिएबल सेट करता है. ये वैरिएबल, आने वाले समय में कमांड चलाने के दौरान काम आ सकते हैं.

echo $GOOGLE_CLOUD_PROJECT

कमांड आउटपुट

<PROJECT_ID>
  1. आखिर में, डिफ़ॉल्ट ज़ोन और प्रोजेक्ट कॉन्फ़िगरेशन सेट करें.
gcloud config set compute/zone us-central1-f

आपके पास कई तरह के ज़ोन चुनने का विकल्प होता है. ज़्यादा जानकारी के लिए, क्षेत्र और ज़ोन.

खास जानकारी

इस चरण में, अपने एनवायरमेंट को सेटअप किया जाता है.

अगला वीडियो

इसके बाद, आपको Cloud Spanner इंस्टेंस सेट अप करना होगा.

3. Cloud Spanner इंस्टेंस सेट अप करना

इस चरण में, हम इस कोडलैब के लिए Cloud Spanner इंस्टेंस सेट अप करते हैं. 1a6580bd3d3e6783.pngसबसे ऊपर बाईं ओर मौजूद हैमबर्गर मेन्यू 3129589f7bc9e5ce.png में स्पैनर एंट्री खोजें या "/" दबाकर स्पैनर खोजें और "स्पैनर" लिखें

36e52f8df8e13b99.png

इसके बाद, 95269e75bc8c3e4d.png पर क्लिक करें और अपने इंस्टेंस के लिए इंस्टेंस का नाम cloudspanner-leaderboard डालकर, एक कॉन्फ़िगरेशन चुनें (कोई क्षेत्रीय इंस्टेंस चुनें) और नोड की संख्या सेट करें. इस कोडलैब के लिए, हमें सिर्फ़ एक नोड की ज़रूरत होगी. प्रोडक्शन इंस्टेंस और Cloud Spanner एसएलए की ज़रूरी शर्तों को पूरा करने के लिए, आपको अपने Cloud Spanner इंस्टेंस में तीन या उससे ज़्यादा नोड चलाने होंगे.

आखिर में, "बनाएं" पर क्लिक करें. और कुछ ही सेकंड में आपके पास Cloud Spanner का इंस्टेंस उपलब्ध हो जाता है.

dceb68e9ed3801e8.png

अगले चरण में, हम अपने नए इंस्टेंस में डेटाबेस और स्कीमा बनाने के लिए, Java क्लाइंट लाइब्रेरी का इस्तेमाल करेंगे.

4. डेटाबेस और स्कीमा बनाना

इस चरण में, हम सैंपल डेटाबेस और स्कीमा बनाते हैं.

Java क्लाइंट लाइब्रेरी का इस्तेमाल करके, दो टेबल बनाते हैं; खिलाड़ी की जानकारी के लिए खिलाड़ी टेबल और खिलाड़ी के स्कोर सेव करने के लिए 'स्कोर' टेबल. इसके लिए, हम Cloud Shell में Java कंसोल ऐप्लिकेशन बनाने का तरीका जानेंगे.

पहले Cloud Shell में यह कमांड टाइप करके, 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# ऐप्लिकेशन के तौर पर मौजूद हैं, ताकि कोडलैब में आपकी प्रोग्रेस के साथ-साथ उसे रेफ़रंस के तौर पर इस्तेमाल किया जा सके. हम एक नई डायरेक्ट्री बनाएंगे और अलग-अलग चरणों में लीडरबोर्ड ऐप्लिकेशन की एक कॉपी बनाएंगे.

"कोडलैब" नाम की नई डायरेक्ट्री बनाएं और निम्न आदेश से इसमें निर्देशिका को बदलें:

mkdir codelab && cd $_

"लीडरबोर्ड" नाम का एक नया बेसिक Java ऐप्लिकेशन बनाएं इस Maven (mvn) कमांड का इस्तेमाल करके:

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

इस निर्देश से एक सामान्य कंसोल ऐप्लिकेशन बनता है. इसमें दो फ़ाइलें, Maven ऐप्लिकेशन की कॉन्फ़िगरेशन फ़ाइल pom.xml और Java ऐप्लिकेशन फ़ाइल App.java शामिल होती हैं.

इसके बाद, डायरेक्ट्री को अभी-अभी बनाई गई लीडरबोर्ड डायरेक्ट्री में बदलें और इसका कॉन्टेंट दिखाएं:

cd leaderboard && ls

आपको pom.xml फ़ाइल और src डायरेक्ट्री, सूची में दिखेगी:

pom.xml  src

आइए, अब App.java में बदलाव करके इस कंसोल ऐप्लिकेशन को अपडेट करते हैं, ताकि Java स्पैनर क्लाइंट लाइब्रेरी का इस्तेमाल करके दो टेबल वाला लीडरबोर्ड बनाया जा सके; खिलाड़ी और स्कोर. Cloud Shell Editor में जाकर ऐसा किया जा सकता है:

नीचे हाइलाइट किए गए आइकॉन पर क्लिक करके, क्लाउड शेल एडिटर खोलें:

73cf70e05f653ca.png

लीडरबोर्ड फ़ोल्डर में pom.xml खोलें. java-docs-samples\ spanner\leaderboard\codelab\leaderboard फ़ोल्डर में मौजूद pom.xml फ़ाइल खोलें. यह फ़ाइल, मेवन बिल्ड सिस्टम को कॉन्फ़िगर करती है, ताकि हमारा ऐप्लिकेशन एक जार में बन सके. इसमें हमारी सभी डिपेंडेंसी भी शामिल हैं.

मौजूदा </property> के ठीक नीचे, नीचे दिया गया एक नया डिपेंडेंसी मैनेजमेंट सेक्शन जोड़ें एलिमेंट:

<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 नई डिपेंडेंसी जोड़ें सेक्शन में शामिल किया गया है, जिससे ऐप्लिकेशन में Cloud Spanner Java क्लाइंट लाइब्रेरी जोड़ दी जाएगी.

    <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 फ़ाइल में आपने जो बदलाव किए हैं उन्हें सेव करें पर जाकर, या "Ctrl" दबाकर और "S" कीबोर्ड के बटन एक साथ.

इसके बाद, src/main/java/com/google/codelabs/ फ़ोल्डर में मौजूद Cloud Shell Editor में App.java फ़ाइल खोलें. फ़ाइल के मौजूदा कोड को, leaderboard डेटाबेस के साथ-साथ Players और Scores टेबल बनाने के लिए ज़रूरी कोड से बदलें. इसके लिए, नीचे दिए गए Java कोड को App.java फ़ाइल में चिपकाएं:

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 फ़ाइल में किए गए बदलाव सेव करें पर जाकर, मेन्यू.

create कमांड को चालू करने के लिए कोड जोड़ने के बाद, आपकी App.java फ़ाइल कैसी दिखनी चाहिए, इसका उदाहरण देखने के लिए, java-docs-samples/spanner/leaderboard/step4/src डायरेक्ट्री में App.java फ़ाइल का इस्तेमाल करें.

अपना ऐप्लिकेशन बनाने के लिए, उस डायरेक्ट्री से mvn पैकेज चलाएं जिसमें आपका pom.xml मौजूद है:

mvn package

आपकी Java जार फ़ाइल बन जाने के बाद, नीचे दिए गए निर्देश को डालकर क्लाउड शेल में ऐप्लिकेशन को चलाएं:

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 कमांड के लिए आर्ग्युमेंट, इंस्टेंस आईडी और डेटाबेस आईडी हैं.

अब नीचे दिया गया कमांड चलाएं.

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

कुछ सेकंड के बाद, आपको कुछ ऐसा जवाब दिखेगा:

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

Cloud Console के Cloud Spanner सेक्शन में, आपको बाईं ओर दिए गए मेन्यू में नया डेटाबेस और टेबल दिखेंगी.

ba9008bb84cb90b0.png

अगले चरण में, हम अपने ऐप्लिकेशन को अपडेट करेंगे, ताकि आपके नए डेटाबेस में कुछ डेटा लोड किया जा सके.

5. डेटा लोड करें

अब हमारे पास leaderboard नाम का एक डेटाबेस है, जिसमें दो टेबल हैं; Players और Scores. अब Java क्लाइंट लाइब्रेरी का इस्तेमाल करके, हमारी Players टेबल में प्लेयर और Scores टेबल को हर प्लेयर के रैंडम स्कोर से भरा जाता है.

अगर यह पहले से खुला नहीं है, तो नीचे हाइलाइट किए गए आइकॉन पर क्लिक करके क्लाउड शेल एडिटर खोलें:

ef49fcbaaed19024.png

इसके बाद, एक insert कमांड जोड़ने के लिए, क्लाउड शेल एडिटर में App.java फ़ाइल में बदलाव करें. इसका इस्तेमाल, Players टेबल में 100 प्लेयर जोड़ने के लिए किया जा सकता है. इसके अलावा, इसका इस्तेमाल Players टेबल में हर प्लेयर के लिए, Scores टेबल में चार रैंडम स्कोर जोड़ने के लिए भी किया जा सकता है.

पहले ऐप्लिकेशन फ़ाइल में सबसे ऊपर मौजूद 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() तरीके के ऊपर, नीचे दिए गए इन्सर्ट, 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) कथन में विधि :

        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()method पर डालें. शामिल करने के निर्देश के लिए सहायता टेक्स्ट शामिल करने के लिए, 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 फ़ाइल में किए गए बदलाव सेव करें पर जाकर, मेन्यू.

insert कमांड को चालू करने के लिए कोड जोड़ने के बाद, आपकी App.java फ़ाइल कैसी दिखनी चाहिए, इसका उदाहरण देखने के लिए, java-docs-samples/spanner/leaderboard/step5/src डायरेक्ट्री में App.java फ़ाइल का इस्तेमाल करें.

आइए, अब ऐप्लिकेशन को फिर से बनाएं और चलाएं, ताकि यह पुष्टि की जा सके कि ऐप्लिकेशन की संभावित निर्देशों की सूची में, नया insert निर्देश शामिल है.

अपना ऐप्लिकेशन बनाने के लिए, उस डायरेक्ट्री से mvn package को चलाएं जहां आपका pom.xml मौजूद है:

mvn package

आपकी Java जार फ़ाइल बन जाने के बाद, नीचे दिए गए निर्देश को चलाएं:

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.

रिस्पॉन्स से यह देखा जा सकता है कि इंस्टेंस आईडी और डेटाबेस आईडी के अलावा, 'प्लेयर' की वैल्यू वाला एक दूसरा आर्ग्युमेंट हो सकता है या ‘स्कोर'.

अब "प्लेयर" जोड़कर, insert कमांड को उन्हीं आर्ग्युमेंट वैल्यू के साथ चलाएं जिनका इस्तेमाल हमने create कमांड करते समय किया था जैसा कि अतिरिक्त "इन्सर्ट का टाइप" तर्क है.

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

कुछ सेकंड के बाद, आपको कुछ ऐसा जवाब दिखेगा:

Done inserting player records...

अब Java क्लाइंट लाइब्रेरी का इस्तेमाल करके, हमारी 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 कमांड में "स्कोर" जोड़ते समय किया था जैसा कि अतिरिक्त "इन्सर्ट का टाइप" तर्क है.

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

कुछ सेकंड के बाद, आपको कुछ ऐसा जवाब दिखेगा:

Done inserting score records...

"इन्सर्ट के टाइप" के साथ insert चल रहा है जिसे scores के तौर पर कॉल किया गया है, 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())

Timestamp कॉलम में, "शामिल करें" कॉलम के टाइमस्टैंप अपने-आप भरने के लिए लेन-देन होता है, तो आप इसके बजाय Java कॉन्सटेंट Value.COMMIT_TIMESTAMP डाल सकते हैं, जैसा कि नीचे दिए गए कोड स्निपेट में किया गया है:

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

अब जबकि हमने डेटा लोड करना पूरा कर लिया है, तो आइए उन वैल्यू की पुष्टि करते हैं जिन्हें हमने अभी-अभी अपनी नई टेबल में लिखा है. पहले leaderboard डेटाबेस चुनें. इसके बाद, Players टेबल चुनें. Data टैब पर क्लिक करें. आपको टेबल के PlayerId और PlayerName कॉलम में डेटा दिखेगा.

7bc2c96293c31c49.png

आइए, Scores टेबल पर क्लिक करके Data टैब चुनकर यह पुष्टि करें कि स्कोर टेबल में भी डेटा मौजूद है. आपको दिखाई देगा कि आपके पास टेबल के PlayerId, Timestamp, और Score कॉलम में डेटा है.

d8a4ee4f13244c19.png

बहुत खूब! कुछ ऐसी क्वेरी चलाने के लिए अपने ऐप्लिकेशन को अपडेट करते हैं जिनका इस्तेमाल हम गेमिंग लीडरबोर्ड बनाने में कर सकते हैं.

6. लीडरबोर्ड क्वेरी चलाएं

अब हमने अपना डेटाबेस सेट अप कर लिया है और अपनी टेबल में जानकारी लोड कर दी है, तो अब इस डेटा का इस्तेमाल करके लीडरबोर्ड बनाते हैं. ऐसा करने के लिए, हमें इन चार सवालों के जवाब देने होंगे:

  1. कौनसे खिलाड़ी "टॉप 10" खिलाड़ी हैं हर समय का?
  2. कौनसे खिलाड़ी "टॉप 10" खिलाड़ी हैं का सुझाव दिया है?
  3. कौनसे खिलाड़ी "टॉप 10" खिलाड़ी हैं महीने का?
  4. कौनसे खिलाड़ी "टॉप 10" खिलाड़ी हैं सप्ताह का?

SQL क्वेरी चलाने के लिए, अपने ऐप्लिकेशन को अपडेट करें. इससे, इन सवालों के जवाब मिलेंगे.

हम एक query कमांड जोड़ेंगे, जो उन सवालों के जवाब देने के लिए क्वेरी चलाने का तरीका देगी जिनसे हमारे लीडरबोर्ड के लिए ज़रूरी जानकारी तैयार होगी.

ऐप्लिकेशन को अपडेट करने और query कमांड जोड़ने के लिए, Cloud Shell Editor में App.java फ़ाइल में बदलाव करें. query निर्देश में दो query विधियां होती हैं, एक में केवल DatabaseClient तर्क लिया जाता है और दूसरा जो घंटों में निर्दिष्ट समयावधि द्वारा परिणामों को फ़िल्टर करने की सुविधा देने के लिए एक अतिरिक्त timespan तर्क लेता है.

नीचे दिए गए दो query तरीकों को, मौजूदा insertScores() तरीके के नीचे और मौजूदा printUsageAndExit() तरीके के ऊपर जोड़ें:

  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 कमांड को काम करने लायक बनाने के लिए, अपने ऐप्लिकेशन के "मुख्य" सेक्शन में मौजूद 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;

"क्वेरी" जोड़ने की प्रक्रिया पूरी करने का आखिरी चरण आपके ऐप्लिकेशन की मुख्य सुविधा "क्वेरी" के लिए सहायता टेक्स्ट जोड़ना है निर्देश को printUsageAndExit()method पर डालें. "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 फ़ाइल का इस्तेमाल करें.

अपना ऐप्लिकेशन बनाने के लिए, उस डायरेक्ट्री से mvn package को चलाएं जहां आपका pom.xml मौजूद है:

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

आपको एक जवाब दिखेगा, जिसमें "टॉप 10" कॉन्टेंट शामिल होगा ये आंकड़े हैं:

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 कमांड चलाते हैं "टाइमस्पैन" तय करके साल के बेहतरीन खिलाड़ी साल के घंटों की संख्या के बराबर है, जो 8,760 है.

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

आपको एक जवाब दिखेगा, जिसमें "टॉप 10" कॉन्टेंट शामिल होगा साल के चुनिंदा खिलाड़ी:

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

आपको एक जवाब दिखेगा, जिसमें "टॉप 10" कॉन्टेंट शामिल होगा नीचे दिए गए प्लेयर की तरह:

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 कमांड चलाकर देखते हैं "समयावधि" तय करके, हफ़्ते के बेहतरीन खिलाड़ी एक हफ़्ते में घंटों की संख्या के बराबर है, जो 168 है.

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

आपको एक जवाब दिखेगा, जिसमें "टॉप 10" कॉन्टेंट शामिल होगा दिए गए हैं, जैसे कि:

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

बहुत बढ़िया!

अब जैसे ही आप रिकॉर्ड जोड़ेंगे, Cloud Spanner आपके डेटाबेस को आपकी ज़रूरत के हिसाब से, बड़े पैमाने पर सेट करेगी. इससे कोई फ़र्क़ नहीं पड़ता कि आपके डेटाबेस में कितनी बढ़ोतरी हो रही है, लेकिन Cloud Spanner और इसकी Truetime टेक्नोलॉजी की मदद से आपके गेम का लीडरबोर्ड सटीक तरीके से लगातार आगे बढ़ सकता है.

7. साफ़-सफ़ाई सेवा

Spanner के साथ खेलने का आनंद लेने के बाद, हमें अपने खेल के मैदान को साफ़ करना होगा, जिससे कीमती संसाधनों और पैसों की बचत होगी. अच्छी बात यह है कि यह एक आसान चरण है. आप Cloud Console के Cloud Spanner सेक्शन में जाकर, "Cloud Spanner इंस्टेंस सेट करें" नाम के कोडलैब चरण में बनाए गए इंस्टेंस को मिटा देते हैं.

8. बधाई हो!

हमने इन विषयों के बारे में बात की:

  • लीडरबोर्ड के लिए Google Cloud स्पैनर इंस्टेंस, डेटाबेस, और टेबल स्कीमा
  • Java कंसोल ऐप्लिकेशन बनाने का तरीका
  • Java क्लाइंट लाइब्रेरी का इस्तेमाल करके स्पैनर डेटाबेस और टेबल बनाने का तरीका
  • Java क्लाइंट लाइब्रेरी का इस्तेमाल करके, स्पैनर डेटाबेस में डेटा लोड करने का तरीका
  • "टॉप 10" से जुड़ी क्वेरी करने का तरीका स्पैनर कमिट टाइमस्टैंप और Java क्लाइंट लाइब्रेरी का इस्तेमाल करके आपके डेटा के नतीजे

अगले चरण:

हमें अपना सुझाव/राय दें या शिकायत करें

  • कृपया थोड़ा समय निकालकर, हमारे बहुत छोटे से सर्वे को पूरा करें