Cloud Spanner: สร้างลีดเดอร์บอร์ดเกมด้วย C#

1. ภาพรวม

Google Cloud Spanner เป็นบริการฐานข้อมูลเชิงสัมพันธ์ที่รองรับการปรับขนาดในวงกว้างและกระจายไปทั่วโลกที่มีการจัดการครบวงจร ซึ่งมอบธุรกรรม ACID และความหมายของ SQL โดยไม่สูญเสียประสิทธิภาพการทำงานและความพร้อมใช้งานสูง

ในห้องทดลองนี้ คุณจะได้ดูวิธีตั้งค่าอินสแตนซ์ Cloud Spanner คุณจะเข้าสู่ขั้นตอนต่างๆ ในการสร้างฐานข้อมูลและสคีมาที่ใช้สำหรับลีดเดอร์บอร์ดการเล่นเกม คุณจะเริ่มต้นด้วยการสร้างตารางผู้เล่นสำหรับจัดเก็บข้อมูลผู้เล่น และตารางคะแนนเพื่อเก็บคะแนนผู้เล่น

ถัดไป คุณจะต้องเติมข้อมูลในตารางด้วยข้อมูลตัวอย่าง จากนั้นคุณจะสรุปห้องทดลองโดยการเรียกใช้คำค้นหาตัวอย่างยอดนิยม 10 อันดับแรก และสุดท้ายให้ลบอินสแตนซ์เพื่อทำให้ทรัพยากรว่างมากขึ้น

สิ่งที่คุณจะได้เรียนรู้

  • วิธีตั้งค่าอินสแตนซ์ Cloud Spanner
  • วิธีสร้างฐานข้อมูลและตาราง
  • วิธีใช้คอลัมน์การประทับเวลาคอมมิต
  • วิธีโหลดข้อมูลลงในตารางฐานข้อมูล 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 ทั้งหมด (ระบบใช้ชื่อด้านบนนี้ไปแล้ว และจะใช้ไม่ได้ ขออภัย) และจะมีการอ้างอิงใน Codelab ว่า PROJECT_ID ในภายหลัง

ขั้นตอนถัดไป คุณจะต้องเปิดใช้การเรียกเก็บเงินใน Developers Console เพื่อใช้ทรัพยากร Google Cloud และเปิดใช้ Cloud Spanner API หากยังไม่ได้ดำเนินการ

15d0ef27a8fbab27.png

การใช้งาน Codelab นี้น่าจะมีค่าใช้จ่ายไม่เกิน 2-3 ดอลลาร์ แต่อาจมากกว่านี้หากคุณตัดสินใจใช้ทรัพยากรเพิ่มหรือปล่อยให้ทำงาน (ดูส่วน "ล้างข้อมูล" ในตอนท้ายของเอกสารนี้) ดูข้อมูลเกี่ยวกับราคาของ Google Cloud Spanner ได้ที่นี่

ผู้ใช้ใหม่ของ Google Cloud Platform จะมีสิทธิ์ทดลองใช้ฟรี$300 ซึ่งจะทำให้ Codelab นี้ไม่มีค่าใช้จ่ายทั้งหมด

การตั้งค่า Google Cloud Shell

แม้ว่า Google Cloud และ Spanner จะทำงานจากระยะไกลได้จากแล็ปท็อป แต่ใน Codelab นี้ เราจะใช้ Google Cloud Shell ซึ่งเป็นสภาพแวดล้อมแบบบรรทัดคำสั่งที่ทำงานในระบบคลาวด์

เครื่องเสมือนแบบ Debian นี้เต็มไปด้วยเครื่องมือการพัฒนาทั้งหมดที่คุณต้องการ โดยมีไดเรกทอรีหลักขนาด 5 GB ที่ทำงานอย่างต่อเนื่องใน Google Cloud ซึ่งจะช่วยเพิ่มประสิทธิภาพของเครือข่ายและการตรวจสอบสิทธิ์ได้อย่างมาก ซึ่งหมายความว่าสิ่งที่คุณต้องมีสำหรับ Codelab นี้คือเบราว์เซอร์ (ใช่แล้ว ทั้งหมดนี้ทำงานได้บน Chromebook)

  1. หากต้องการเปิดใช้งาน Cloud Shell จาก Cloud Console เพียงคลิกเปิดใช้งาน Cloud Shell gcLMt5IuEcJJNnMId-Bcz3sxCd0rZn7IzT_r95C8UZeqML68Y1efBG_B0VRp7hc7qiZTLAF-TXD7SsOadxn8uadgHhaLeASnVS3ZHK39eOlKJOgj9SJua_oeGhMxRrbOg3qigddS2A (จะใช้เวลาเพียงไม่นานในการจัดสรรและเชื่อมต่อกับสภาพแวดล้อม)

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

Screen Shot 14-06-2017 เวลา 22.13.43 น.

เมื่อเชื่อมต่อกับ 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 สำหรับ Codelab นี้ ค้นหารายการ Spanner 1a6580bd3d3e6783.pngในเมนูแฮมเบอร์เกอร์ 3129589f7bc9e5ce.png ด้านบนซ้าย หรือค้นหา Spanner โดยกด "/" และพิมพ์ "SPANer"

36e52f8df8e13b99.png

ถัดไป ให้คลิก 95269e75bc8c3e4d.png และกรอกแบบฟอร์มโดยป้อนชื่ออินสแตนซ์ cloudspanner-leaderboard สำหรับอินสแตนซ์ เลือกการกำหนดค่า (เลือกอินสแตนซ์ระดับภูมิภาค) และกำหนดจำนวนโหนด สำหรับ Codelab นี้ เราต้องการเพียง 1 โหนดเท่านั้น สำหรับอินสแตนซ์ที่ใช้งานจริงและเพื่อให้มีคุณสมบัติสำหรับ SLA ของ Cloud Spanner คุณจะต้องเรียกใช้โหนดอย่างน้อย 3 รายการในอินสแตนซ์ Cloud Spanner

สุดท้ายแต่ไม่ท้ายสุด ให้คลิก "สร้าง" และคุณก็มีอินสแตนซ์ Cloud Spanner อยู่แล้วภายในไม่กี่วินาที

dceb68e9ed3801e8.png

ในขั้นตอนถัดไป เราจะใช้ไลบรารีของไคลเอ็นต์ C# เพื่อสร้างฐานข้อมูลและสคีมาในอินสแตนซ์ใหม่ของเรา

4. สร้างฐานข้อมูลและสคีมา

ในขั้นตอนนี้ เราจะสร้างฐานข้อมูลและสคีมาตัวอย่าง

ลองใช้ไลบรารีของไคลเอ็นต์ C# เพื่อสร้างตาราง 2 ตาราง ดังนี้ ตารางผู้เล่นสำหรับข้อมูลผู้เล่นและตารางคะแนนสำหรับจัดเก็บคะแนนผู้เล่น ในการดำเนินการนี้ เราจะแนะนำขั้นตอนการสร้างแอปพลิเคชันคอนโซล C# ใน Cloud Shell

ก่อนอื่น ให้โคลนโค้ดตัวอย่างสำหรับ Codelab นี้จาก GitHub โดยพิมพ์คำสั่งต่อไปนี้ใน Cloud Shell

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

จากนั้นเปลี่ยนไดเรกทอรีเป็น "แอปพลิเคชัน" ไดเรกทอรีที่คุณจะใช้สร้างแอปพลิเคชัน

cd dotnet-docs-samples/applications/

โค้ดทั้งหมดที่จำเป็นสำหรับ Codelab นี้จะอยู่ในไดเรกทอรี dotnet-docs-samples/applications/leaderboard ที่มีอยู่ โดยเป็นแอปพลิเคชัน C# ที่เรียกใช้ได้ชื่อ Leaderboard เพื่อใช้อ้างอิงขณะดำเนินการใน Codelab เราจะสร้างไดเรกทอรีใหม่และสำเนาของแอปพลิเคชันลีดเดอร์บอร์ดเป็นขั้นตอน

สร้างไดเรกทอรีใหม่ชื่อ "codelab" สำหรับแอปพลิเคชันและเปลี่ยนไดเรกทอรีลงในไดเรกทอรีด้วยคำสั่งต่อไปนี้

mkdir codelab && cd $_

สร้างแอปพลิเคชันคอนโซล .NET C# ใหม่ชื่อ "ลีดเดอร์บอร์ด" โดยใช้คำสั่งต่อไปนี้

dotnet new console -n Leaderboard

คำสั่งนี้จะสร้างแอปพลิเคชันคอนโซลแบบง่ายที่ประกอบด้วยไฟล์หลัก 2 ไฟล์ ได้แก่ ไฟล์โครงการ Leaderboard.csproj และไฟล์โปรแกรม Program.cs

มาเริ่มใช้งานกันเลย เปลี่ยนไดเรกทอรีให้เป็นไดเรกทอรีลีดเดอร์บอร์ดที่สร้างใหม่ซึ่งมีแอปพลิเคชันอยู่

cd Leaderboard

จากนั้นป้อนคำสั่งต่อไปนี้เพื่อเรียกใช้

dotnet run

คุณควรเห็นเอาต์พุตของแอปพลิเคชัน " Hello World!"

ตอนนี้เรามาอัปเดตแอปคอนโซลโดยแก้ไข Program.cs เพื่อใช้ไลบรารีของไคลเอ็นต์ C# Spanner เพื่อสร้างลีดเดอร์บอร์ดที่ประกอบด้วยตารางผู้เล่นและคะแนน 2 ตาราง โดยทำใน Cloud Shell Editor เลย ดังนี้

เปิด Cloud Shell Editor โดยคลิกไอคอนที่ไฮไลต์ด้านล่าง

73cf70e05f653ca.png

จากนั้นเปิดไฟล์ Program.cs ใน Cloud Shell Editor และแทนที่โค้ดที่มีอยู่ของไฟล์ด้วยโค้ดที่ต้องใช้ในการสร้างฐานข้อมูล leaderboard และตาราง Players และ Scores โดยวางโค้ดแอปพลิเคชัน C# ต่อไปนี้ลงในไฟล์ Program.cs

using System;
using System.Threading.Tasks;
using Google.Cloud.Spanner.Data;
using CommandLine;

namespace GoogleCloudSamples.Leaderboard
{
    [Verb("create", HelpText = "Create a sample Cloud Spanner database "
        + "along with sample 'Players' and 'Scores' tables in your project.")]
    class CreateOptions
    {
        [Value(0, HelpText = "The project ID of the project to use "
            + "when creating Cloud Spanner resources.", Required = true)]
        public string projectId { get; set; }
        [Value(1, HelpText = "The ID of the instance where the sample database "
            + "will be created.", Required = true)]
        public string instanceId { get; set; }
        [Value(2, HelpText = "The ID of the sample database to create.",
            Required = true)]
        public string databaseId { get; set; }
    }

    public class Program
    {
        enum ExitCode : int
        {
            Success = 0,
            InvalidParameter = 1,
        }

        public static object Create(string projectId,
            string instanceId, string databaseId)
        {
            var response =
                CreateAsync(projectId, instanceId, databaseId);
            Console.WriteLine("Waiting for operation to complete...");
            response.Wait();
            Console.WriteLine($"Operation status: {response.Status}");
            Console.WriteLine($"Created sample database {databaseId} on "
                + $"instance {instanceId}");
            return ExitCode.Success;
        }

        public static async Task CreateAsync(
            string projectId, string instanceId, string databaseId)
        {
            // Initialize request connection string for database creation.
            string connectionString =
                $"Data Source=projects/{projectId}/instances/{instanceId}";
            using (var connection = new SpannerConnection(connectionString))
            {
                string createStatement = $"CREATE DATABASE `{databaseId}`";
                string[] createTableStatements = new string[] {
                  // Define create table statement for Players table.
                  @"CREATE TABLE Players(
                    PlayerId INT64 NOT NULL,
                    PlayerName STRING(2048) NOT NULL
                  ) PRIMARY KEY(PlayerId)",
                  // Define create table statement for Scores table.
                  @"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" };
                // Make the request.
                var cmd = connection.CreateDdlCommand(
                    createStatement, createTableStatements);
                try
                {
                    await cmd.ExecuteNonQueryAsync();
                }
                catch (SpannerException e) when
                    (e.ErrorCode == ErrorCode.AlreadyExists)
                {
                    // OK.
                }
            }
        }

        public static int Main(string[] args)
        {
            var verbMap = new VerbMap<object>();
            verbMap
                .Add((CreateOptions opts) => Create(
                    opts.projectId, opts.instanceId, opts.databaseId))
                .NotParsedFunc = (err) => 1;
            return (int)verbMap.Run(args);
        }
    }
}

เพื่อให้เห็นภาพของรหัสโปรแกรมได้ชัดเจนขึ้น ต่อไปนี้เป็นแผนภาพของโปรแกรมซึ่งมีองค์ประกอบหลักๆ กำกับไว้:

b70b1b988ea3ac8a.png

คุณสามารถใช้ไฟล์ Program.cs ในไดเรกทอรี dotnet-docs-samples/applications/leaderboard/step4 เพื่อดูตัวอย่างว่าไฟล์ Program.cs ควรมีลักษณะอย่างไรหลังจากเพิ่มโค้ดเพื่อเปิดใช้คำสั่ง create

จากนั้นใช้ Cloud Shell Editor เพื่อเปิดและแก้ไขไฟล์โปรเจ็กต์ Leaderboard.csproj โดยอัปเดตเป็นโค้ดต่อไปนี้ ตรวจสอบว่าได้บันทึกการเปลี่ยนแปลงทั้งหมดโดยใช้ "ไฟล์" ของ Cloud Shell Editor

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp3.1</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Google.Cloud.Spanner.Data" Version="3.3.0" />
  </ItemGroup>

  <ItemGroup>
    <ProjectReference Include="..\..\..\commandlineutil\Lib\CommandLineUtil.csproj" />
  </ItemGroup>

</Project>

การเปลี่ยนแปลงนี้เพิ่มการอ้างอิงไปยังแพ็กเกจ C# Spanner Nuget Google.Cloud.Spanner.Data ซึ่งเราจำเป็นต้องโต้ตอบกับ Cloud Spanner API การเปลี่ยนแปลงนี้ยังเพิ่มการอ้างอิงไปยังโปรเจ็กต์ CommandLineUtil ซึ่งเป็นส่วนหนึ่งของที่เก็บ GitHub แบบ Dotnet-doc-ตัวอย่าง และให้ "คำกริยา" ที่เป็นประโยชน์ เป็นโอเพนซอร์ส CommandLineParser ไลบรารีที่มีประโยชน์สำหรับการจัดการอินพุตบรรทัดคำสั่งสำหรับแอปพลิเคชันคอนโซล

คุณสามารถใช้ไฟล์ Leaderboard.csproj ในไดเรกทอรี dotnet-docs-samples/applications/leaderboard/step4 เพื่อดูตัวอย่างว่าไฟล์ Leaderboard.csproj ควรมีลักษณะอย่างไรหลังจากเพิ่มโค้ดเพื่อเปิดใช้คำสั่ง create

ตอนนี้คุณก็พร้อมที่จะเรียกใช้ตัวอย่างที่อัปเดตแล้ว พิมพ์ข้อความต่อไปนี้เพื่อดูการตอบกลับเริ่มต้นของแอปพลิเคชันที่อัปเดต

dotnet run

คุณควรเห็นผลลัพธ์ดังต่อไปนี้

Leaderboard 1.0.0
Copyright (C) 2018 Leaderboard

ERROR(S):
  No verb selected.

  create     Create a sample Cloud Spanner database along with sample 'Players' and 'Scores' tables in your project.

  help       Display more information on a specific command.

  version    Display version information.

จากคำตอบนี้ เราจะเห็นได้ว่านี่คือแอปพลิเคชัน Leaderboard ซึ่งทำงานได้ด้วย 1 ใน 3 คำสั่งที่เป็นไปได้ ได้แก่ create, help และ version

ลองใช้คำสั่ง create เพื่อสร้างฐานข้อมูลและตาราง Spanner เรียกใช้คำสั่งโดยไม่มีอาร์กิวเมนต์เพื่อดูอาร์กิวเมนต์ที่คาดไว้ของคำสั่ง

dotnet run create

คุณควรเห็นการตอบกลับดังตัวอย่างต่อไปนี้

Leaderboard 1.0.0
Copyright (C) 2018 Leaderboard

ERROR(S):
  A required value not bound to option name is missing.

  --help          Display this help screen.

  --version       Display version information.

  value pos. 0    Required. The project ID of the project to use when creating Cloud Spanner resources.

  value pos. 1    Required. The ID of the instance where the sample database will be created.

  value pos. 2    Required. The ID of the sample database to create.

ตรงนี้เราจะเห็นว่าอาร์กิวเมนต์ที่คาดไว้ของคำสั่ง create คือรหัสโปรเจ็กต์ รหัสอินสแตนซ์ และรหัสฐานข้อมูล

จากนั้นเรียกใช้คำสั่งต่อไปนี้ อย่าลืมแทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ที่คุณสร้างในตอนต้นของ Codelab นี้

dotnet run create PROJECT_ID cloudspanner-leaderboard leaderboard

หลังจากผ่านไป 2-3 วินาที คุณควรเห็นคำตอบดังนี้

Waiting for operation to complete...
Operation status: RanToCompletion
Created sample database leaderboard on instance cloudspanner-leaderboard

ในส่วน Cloud Spanner ของ Cloud Console คุณควรจะเห็นฐานข้อมูลและตารางใหม่แสดงในเมนูด้านซ้ายมือ

ba9008bb84cb90b0.png

ในขั้นตอนถัดไป เราจะอัปเดตแอปพลิเคชันให้โหลดข้อมูลบางอย่างลงในฐานข้อมูลใหม่

5. โหลดข้อมูล

ตอนนี้เรามีฐานข้อมูลชื่อ leaderboard ที่มี 2 ตารางแล้ว Players และ Scores ตอนนี้ให้ใช้ไลบรารีของไคลเอ็นต์ C# เพื่อป้อนข้อมูลผู้เล่นในตาราง Players และตาราง Scores เพื่อแสดงคะแนนแบบสุ่มสำหรับผู้เล่นแต่ละคน

เปิด Cloud Shell Editor โดยคลิกไอคอนที่ไฮไลต์ด้านล่าง

4d17840699d8e7ce.png

จากนั้นแก้ไขไฟล์ Program.cs ใน Cloud Shell Editor เพื่อเพิ่มคำสั่ง insert ที่สามารถใช้แทรกผู้เล่น 100 คนในตาราง Players หรือใช้เพื่อแทรกคะแนนแบบสุ่ม 4 รายการในตาราง Scores สำหรับผู้เล่นแต่ละคนในตาราง Players

ก่อนอื่นให้เพิ่มบล็อกคำสั่ง insert ใหม่ใน "Verbmap" ที่ด้านบนของโปรแกรม ใต้บล็อกคำสั่ง create ที่มีอยู่

[Verb("insert", HelpText = "Insert sample 'players' records or 'scores' records "
        + "into the database.")]
    class InsertOptions
    {
        [Value(0, HelpText = "The project ID of the project to use "
            + "when managing Cloud Spanner resources.", Required = true)]
        public string projectId { get; set; }
        [Value(1, HelpText = "The ID of the instance where the sample database resides.",
            Required = true)]
        public string instanceId { get; set; }
        [Value(2, HelpText = "The ID of the database where the sample database resides.",
            Required = true)]
        public string databaseId { get; set; }
        [Value(3, HelpText = "The type of insert to perform, 'players' or 'scores'.",
            Required = true)]
        public string insertType { get; set; }
    }

จากนั้น เพิ่มเมธอด Insert, InsertPlayersAsync และ InsertScoresAsync ต่อไปนี้ใต้เมธอด CreateAsync ที่มีอยู่:

        public static object Insert(string projectId,
            string instanceId, string databaseId, string insertType)
        {
            if (insertType.ToLower() == "players")
            {
                var responseTask =
                    InsertPlayersAsync(projectId, instanceId, databaseId);
                Console.WriteLine("Waiting for insert players operation to complete...");
                responseTask.Wait();
                Console.WriteLine($"Operation status: {responseTask.Status}");
            }
            else if (insertType.ToLower() == "scores")
            {
                var responseTask =
                    InsertScoresAsync(projectId, instanceId, databaseId);
                Console.WriteLine("Waiting for insert scores operation to complete...");
                responseTask.Wait();
                Console.WriteLine($"Operation status: {responseTask.Status}");
            }
            else
            {
                Console.WriteLine("Invalid value for 'type of insert'. "
                    + "Specify 'players' or 'scores'.");
                return ExitCode.InvalidParameter;
            }
            Console.WriteLine($"Inserted {insertType} into sample database "
                + $"{databaseId} on instance {instanceId}");
            return ExitCode.Success;
        }

       public static async Task InsertPlayersAsync(string projectId,
            string instanceId, string databaseId)
        {
            string connectionString =
                $"Data Source=projects/{projectId}/instances/{instanceId}"
                + $"/databases/{databaseId}";

            long numberOfPlayers = 0;
            using (var connection = new SpannerConnection(connectionString))
            {
                await connection.OpenAsync();
                await connection.RunWithRetriableTransactionAsync(async (transaction) =>
                {
                    // Execute a SQL statement to get current number of records
                    // in the Players table to use as an incrementing value 
                    // for each PlayerName to be inserted.
                    var cmd = connection.CreateSelectCommand(
                        @"SELECT Count(PlayerId) as PlayerCount FROM Players");
                    numberOfPlayers = await cmd.ExecuteScalarAsync<long>();
                    // Insert 100 player records into the Players table.
                    SpannerBatchCommand cmdBatch = connection.CreateBatchDmlCommand();
                    for (int i = 0; i < 100; i++)
                    {
                        numberOfPlayers++;
                        SpannerCommand cmdInsert = connection.CreateDmlCommand(
                            "INSERT INTO Players "
                            + "(PlayerId, PlayerName) "
                            + "VALUES (@PlayerId, @PlayerName)",
                                new SpannerParameterCollection {
                                    {"PlayerId", SpannerDbType.Int64},
                                    {"PlayerName", SpannerDbType.String}});
                        cmdInsert.Parameters["PlayerId"].Value =
                            Math.Abs(Guid.NewGuid().GetHashCode());
                        cmdInsert.Parameters["PlayerName"].Value =
                            $"Player {numberOfPlayers}";
                        cmdBatch.Add(cmdInsert);
                    }
                    await cmdBatch.ExecuteNonQueryAsync();
                });
            }
            Console.WriteLine("Done inserting player records...");
        }

        public static async Task InsertScoresAsync(
            string projectId, string instanceId, string databaseId)
        {
            string connectionString =
            $"Data Source=projects/{projectId}/instances/{instanceId}"
            + $"/databases/{databaseId}";

            // Insert 4 score records into the Scores table for each player
            // in the Players table.
            using (var connection = new SpannerConnection(connectionString))
            {
                await connection.OpenAsync();
                await connection.RunWithRetriableTransactionAsync(async (transaction) =>
                {
                    Random r = new Random();
                    bool playerRecordsFound = false;
                    SpannerBatchCommand cmdBatch =
                                connection.CreateBatchDmlCommand();
                    var cmdLookup =
                    connection.CreateSelectCommand("SELECT * FROM Players");
                    using (var reader = await cmdLookup.ExecuteReaderAsync())
                    {
                        while (await reader.ReadAsync())
                        {
                            playerRecordsFound = true;
                            for (int i = 0; i < 4; i++)
                            {
                                DateTime randomTimestamp = DateTime.Now
                                        .AddYears(r.Next(-2, 1))
                                        .AddMonths(r.Next(-12, 1))
                                        .AddDays(r.Next(-28, 0))
                                        .AddHours(r.Next(-24, 0))
                                        .AddSeconds(r.Next(-60, 0))
                                        .AddMilliseconds(r.Next(-100000, 0));
                                SpannerCommand cmdInsert =
                                connection.CreateDmlCommand(
                                    "INSERT INTO Scores "
                                    + "(PlayerId, Score, Timestamp) "
                                    + "VALUES (@PlayerId, @Score, @Timestamp)",
                                    new SpannerParameterCollection {
                                        {"PlayerId", SpannerDbType.Int64},
                                        {"Score", SpannerDbType.Int64},
                                        {"Timestamp",
                                            SpannerDbType.Timestamp}});
                                cmdInsert.Parameters["PlayerId"].Value =
                                    reader.GetFieldValue<int>("PlayerId");
                                cmdInsert.Parameters["Score"].Value =
                                    r.Next(1000, 1000001);
                                cmdInsert.Parameters["Timestamp"].Value =
                                    randomTimestamp.ToString("o");
                                cmdBatch.Add(cmdInsert);
                            }
                        }
                        if (!playerRecordsFound)
                        {
                            Console.WriteLine("Parameter 'scores' is invalid "
                            + "since no player records currently exist. First "
                            + "insert players then insert scores.");
                            Environment.Exit((int)ExitCode.InvalidParameter);
                        }
                        else
                        {
                            await cmdBatch.ExecuteNonQueryAsync();
                            Console.WriteLine(
                                "Done inserting score records..."
                            );
                        }
                    }
                });
            }
        }

จากนั้นหากต้องการทำให้คำสั่ง insert ทำงานได้ ให้เพิ่มโค้ดต่อไปนี้ลงใน "Main" ของโปรแกรม วิธีการ:

                .Add((InsertOptions opts) => Insert(
                    opts.projectId, opts.instanceId, opts.databaseId, opts.insertType))

คุณสามารถใช้ไฟล์ Program.cs ในไดเรกทอรี dotnet-docs-samples/applications/leaderboard/step5 เพื่อดูตัวอย่างว่าไฟล์ Program.cs ควรมีลักษณะอย่างไรหลังจากเพิ่มโค้ดเพื่อเปิดใช้คำสั่ง insert

ตอนนี้เราจะมาเรียกใช้โปรแกรมเพื่อยืนยันว่าคำสั่ง insert ใหม่รวมอยู่ในรายการคำสั่งที่เป็นไปได้ของโปรแกรมแล้ว เรียกใช้คำสั่งต่อไปนี้

dotnet run

ตอนนี้คุณควรเห็นคำสั่ง insert รวมอยู่ในเอาต์พุตเริ่มต้นของโปรแกรมแล้ว

Leaderboard 1.0.0
Copyright (C) 2018 Leaderboard

ERROR(S):
  No verb selected.

  create     Create a sample Cloud Spanner database along with sample 'Players' and 'Scores' tables in your project.

  insert     Insert sample 'players' records or 'scores' records into the database.

  help       Display more information on a specific command.

  version    Display version information.

ตอนนี้ มาเรียกใช้คำสั่ง insert เพื่อดูอาร์กิวเมนต์อินพุต ป้อนคำสั่งต่อไปนี้

dotnet run insert

การดำเนินการนี้ควรส่งคืนการตอบกลับต่อไปนี้:

Leaderboard 1.0.0
Copyright (C) 2018 Leaderboard

ERROR(S):
  A required value not bound to option name is missing.

  --help          Display this help screen.

  --version       Display version information.

  value pos. 0    Required. The project ID of the project to use when managing Cloud Spanner resources.

  value pos. 1    Required. The ID of the instance where the sample database resides.

  value pos. 2    Required. The ID of the database where the sample database resides.

  value pos. 3    Required. The type of insert to perform, 'players' or 'scores'.

จากการตอบกลับว่า นอกจากรหัสโครงการ รหัสอินสแตนซ์ และรหัสฐานข้อมูลแล้วยังมีอาร์กิวเมนต์อีก value pos. 3 รายการที่ควรเป็น "ประเภทของการแทรก" ที่จะดำเนินการ อาร์กิวเมนต์นี้มีค่าเป็น "players" (ผู้เล่น) หรือ "คะแนน"

ตอนนี้ เราจะมาเรียกใช้คำสั่ง insert ด้วยค่าอาร์กิวเมนต์เหมือนกับที่เราใช้เมื่อเรียกใช้คำสั่ง create โดยเพิ่ม "players" เป็น "ประเภทการแทรก" เพิ่มเติม อาร์กิวเมนต์ อย่าลืมแทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ที่คุณสร้างในตอนต้นของ Codelab นี้

dotnet run insert PROJECT_ID cloudspanner-leaderboard leaderboard players

หลังจากผ่านไป 2-3 วินาที คุณควรเห็นคำตอบดังนี้

Waiting for insert players operation to complete...
Done inserting player records...
Operation status: RanToCompletion
Inserted players into sample database leaderboard on instance cloudspanner-leaderboard

ต่อไปเราจะใช้ไลบรารีของไคลเอ็นต์ C# เพื่อป้อนข้อมูลในตาราง Scores โดยมีคะแนนแบบสุ่ม 4 รายการพร้อมการประทับเวลาของผู้เล่นแต่ละคนในตาราง Players

คอลัมน์ Timestamp ของตาราง Scores ได้รับการกำหนดเป็น "การประทับเวลาคอมมิต" ผ่านคำสั่ง 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 ในแถวของตารางที่ระบุ

คุณยังแทรกค่าการประทับเวลาของตัวเองลงใน "คอมมิตการประทับเวลา" ได้ด้วย ตราบใดที่คุณแทรกการประทับเวลาด้วยค่าที่ผ่านมาแล้ว ซึ่งเป็นสิ่งที่เราจะทำเพื่อวัตถุประสงค์ของ Codelab นี้

คราวนี้ เราจะมาเรียกใช้คำสั่ง insert ด้วยค่าอาร์กิวเมนต์เดียวกันกับที่เราใช้เมื่อเรียกคำสั่ง create ที่เพิ่ม "scores" เป็น "ประเภทการแทรก" เพิ่มเติม อาร์กิวเมนต์ อย่าลืมแทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ที่คุณสร้างในตอนต้นของ Codelab นี้

dotnet run insert PROJECT_ID cloudspanner-leaderboard leaderboard scores

หลังจากผ่านไป 2-3 วินาที คุณควรเห็นคำตอบดังนี้

Waiting for insert players operation to complete...
Done inserting player records...
Operation status: RanToCompletion
Inserted players into sample database leaderboard on instance cloudspanner-leaderboard

การเรียกใช้ insert ด้วย "ประเภทการแทรก" ที่ระบุเป็น scores จะเรียกเมธอด InsertScoresAsync ซึ่งใช้ข้อมูลโค้ดต่อไปนี้เพื่อแทรกการประทับเวลาที่สร้างขึ้นแบบสุ่มที่มีวันที่และเวลาที่เกิดขึ้นในอดีต

DateTime randomTimestamp = DateTime.Now
    .AddYears(r.Next(-2, 1))
    .AddMonths(r.Next(-12, 1))
    .AddDays(r.Next(-28, 0))
    .AddHours(r.Next(-24, 0))
    .AddSeconds(r.Next(-60, 0))
    .AddMilliseconds(r.Next(-100000, 0));
...
 cmdInsert.Parameters["Timestamp"].Value = randomTimestamp.ToString("o");

ป้อนข้อมูลในคอลัมน์ Timestamp โดยอัตโนมัติด้วยการประทับเวลา "แทรก" เกิดขึ้น คุณสามารถแทรกค่าคงที่ SpannerParameter.CommitTimestamp ของ C# ดังเช่นในข้อมูลโค้ดต่อไปนี้

cmd.Parameters["Timestamp"].Value = SpannerParameter.CommitTimestamp;

ตอนนี้เราโหลดข้อมูลเสร็จแล้ว เรามาตรวจสอบค่าที่เราเพิ่งเขียนในตารางใหม่กัน ก่อนอื่น ให้เลือกฐานข้อมูล leaderboard แล้วเลือกตาราง Players คลิกแท็บ Data คุณควรเห็นข้อมูลในคอลัมน์ PlayerId และ PlayerName ของตาราง

7bc2c96293c31c49.png

ถัดไป มายืนยันว่าตารางคะแนนมีข้อมูลโดยคลิกตาราง Scores แล้วเลือกแท็บ Data กัน คุณควรเห็นข้อมูลในคอลัมน์ PlayerId, Timestamp และ Score ของตาราง

d8a4ee4f13244c19.png

เยี่ยมมาก! มาอัปเดตโปรแกรมเพื่อเรียกใช้ข้อความค้นหาที่เราสามารถใช้สร้างลีดเดอร์บอร์ดเกมได้

6. เรียกใช้การค้นหาลีดเดอร์บอร์ด

เมื่อเราตั้งค่าฐานข้อมูลและโหลดข้อมูลลงในตารางแล้ว ลองสร้างลีดเดอร์บอร์ดโดยใช้ข้อมูลนี้กัน ด้วยเหตุนี้ เราจึงต้องตอบคำถาม 4 ข้อต่อไปนี้

  1. ผู้เล่นคนใดบ้างที่อยู่ใน "สิบอันดับแรก" ของช่วงเวลาทั้งหมด
  2. ผู้เล่นคนใดบ้างที่อยู่ใน "สิบอันดับแรก" ของปีนี้คืออะไร
  3. ผู้เล่นคนใดบ้างที่อยู่ใน "สิบอันดับแรก" ของเดือนนี้
  4. ผู้เล่นคนใดบ้างที่อยู่ใน "สิบอันดับแรก" ของสัปดาห์นี้กัน

มาอัปเดตโปรแกรมให้เรียกใช้การค้นหา SQL ที่จะช่วยตอบคำถามเหล่านี้กัน

เราจะเพิ่มคำสั่ง query ที่ให้วิธีการเรียกใช้คำค้นหาเพื่อตอบคำถามที่จะสร้างข้อมูลที่จำเป็นสำหรับลีดเดอร์บอร์ดของเรา

แก้ไขไฟล์ Program.cs ใน Cloud Shell Editor เพื่ออัปเดตโปรแกรมและเพิ่มคำสั่ง query

ก่อนอื่นให้เพิ่มบล็อกคำสั่ง query ใหม่ใน "Verbmap" ที่ด้านบนของโปรแกรม ใต้บล็อกคำสั่ง insert ที่มีอยู่

    [Verb("query", HelpText = "Query players with 'Top Ten' scores within a specific timespan "
        + "from sample Cloud Spanner database table.")]
    class QueryOptions
    {
        [Value(0, HelpText = "The project ID of the project to use "
            + "when managing Cloud Spanner resources.", Required = true)]
        public string projectId { get; set; }
        [Value(1, HelpText = "The ID of the instance where the sample data resides.",
            Required = true)]
        public string instanceId { get; set; }
        [Value(2, HelpText = "The ID of the database where the sample data resides.",
            Required = true)]
        public string databaseId { get; set; }
        [Value(3, Default = 0, HelpText = "The timespan in hours that will be used to filter the "
            + "results based on a record's timestamp. The default will return the "
            + "'Top Ten' scores of all time.")]
        public int timespan { get; set; }
    }

จากนั้น เพิ่มเมธอด Query และ QueryAsync ต่อไปนี้ใต้เมธอด InsertScoresAsync ที่มีอยู่:

public static object Query(string projectId,
            string instanceId, string databaseId, int timespan)
        {
            var response = QueryAsync(
                projectId, instanceId, databaseId, timespan);
            response.Wait();
            return ExitCode.Success;
        }        

public static async Task QueryAsync(
            string projectId, string instanceId, string databaseId, int timespan)
        {
            string connectionString =
            $"Data Source=projects/{projectId}/instances/"
            + $"{instanceId}/databases/{databaseId}";
            // Create connection to Cloud Spanner.
            using (var connection = new SpannerConnection(connectionString))
            {
                string sqlCommand;
                if (timespan == 0)
                {
                    // No timespan specified. Query Top Ten scores of all time.
                    sqlCommand =
                        @"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";
                }
                else
                {
                    // Query Top Ten scores filtered by the timepan specified.
                    sqlCommand =
                        $@"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.ToString()} HOUR)
                            ORDER BY s.Score DESC LIMIT 10";
                }
                var cmd = connection.CreateSelectCommand(sqlCommand);
                using (var reader = await cmd.ExecuteReaderAsync())
                {
                    while (await reader.ReadAsync())
                    {
                        Console.WriteLine("PlayerId : "
                          + reader.GetFieldValue<string>("PlayerId")
                          + " PlayerName : "
                          + reader.GetFieldValue<string>("PlayerName")
                          + " Score : "
                          + string.Format("{0:n0}",
                            Int64.Parse(reader.GetFieldValue<string>("Score")))
                          + " Timestamp : "
                          + reader.GetFieldValue<string>("Timestamp").Substring(0, 10));
                    }
                }
            }
        }

จากนั้นหากต้องการทำให้คำสั่ง query ทำงานได้ ให้เพิ่มโค้ดต่อไปนี้ลงใน "Main" ของโปรแกรม วิธีการ:

                .Add((QueryOptions opts) => Query(
                    opts.projectId, opts.instanceId, opts.databaseId, opts.timespan))

คุณสามารถใช้ไฟล์ Program.cs ในไดเรกทอรี dotnet-docs-samples/applications/leaderboard/step6 เพื่อดูตัวอย่างว่าไฟล์ Program.cs ควรมีลักษณะอย่างไรหลังจากเพิ่มโค้ดเพื่อเปิดใช้คำสั่ง query

ตอนนี้เราจะมาเรียกใช้โปรแกรมเพื่อยืนยันว่าคำสั่ง query ใหม่รวมอยู่ในรายการคำสั่งที่เป็นไปได้ของโปรแกรมแล้ว เรียกใช้คำสั่งต่อไปนี้

dotnet run

คุณควรเห็นคำสั่ง query รวมอยู่ในเอาต์พุตเริ่มต้นของโปรแกรมเป็นตัวเลือกคำสั่งใหม่ดังนี้

Leaderboard 1.0.0
Copyright (C) 2018 Leaderboard

ERROR(S):
  No verb selected.

  create     Create a sample Cloud Spanner database along with sample 'Players' and 'Scores' tables in your project.

  insert     Insert sample 'players' records or 'scores' records into the database.

  query      Query players with 'Top Ten' scores within a specific timespan from sample Cloud Spanner database table.

  help       Display more information on a specific command.

  version    Display version information.

ตอนนี้ มาเรียกใช้คำสั่ง query เพื่อดูอาร์กิวเมนต์อินพุต ป้อนคำสั่ง

dotnet run query

การดำเนินการนี้จะแสดงการตอบกลับต่อไปนี้

Leaderboard 1.0.0
Copyright (C) 2018 Leaderboard

ERROR(S):
  A required value not bound to option name is missing.

  --help          Display this help screen.

  --version       Display version information.

  value pos. 0    Required. The project ID of the project to use when managing Cloud Spanner resources.

  value pos. 1    Required. The ID of the instance where the sample data resides.

  value pos. 2    Required. The ID of the database where the sample data resides.

  value pos. 3    (Default: 0) The timespan in hours that will be used to filter the results based on a record's timestamp. The default will return the 'Top Ten' scores of all time.

ดูจากคำตอบได้ว่านอกเหนือจากรหัสโปรเจ็กต์ รหัสอินสแตนซ์ และรหัสฐานข้อมูลแล้วยังมีอาร์กิวเมนต์ value pos. 3 อีกรายการหนึ่งซึ่งคาดว่าจะช่วยระบุช่วงเวลาเป็นจํานวนชั่วโมงที่จะใช้ในการกรองระเบียนโดยอิงตามค่าในคอลัมน์ Timestamp ของตาราง Scores ได้ อาร์กิวเมนต์นี้มีค่าเริ่มต้นเป็น 0 ซึ่งหมายความว่าไม่มีการกรองระเบียนตามการประทับเวลา เราจึงใช้คำสั่ง query ได้โดยไม่ต้องมี "timespan" เพื่อรับรายการ "ท็อป 10" ของเรา ผู้เล่นตลอดกาล

มาเรียกใช้คำสั่ง query โดยไม่ระบุ "timespan" โดยใช้ค่าอาร์กิวเมนต์เดียวกันกับที่เราใช้เมื่อเรียกใช้คำสั่ง create อย่าลืมแทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ที่คุณสร้างในตอนต้นของ Codelab นี้

dotnet run query PROJECT_ID cloudspanner-leaderboard leaderboard

คุณควรจะเห็นการตอบกลับที่มี "สูงสุด 10 อันดับแรก" ของผู้เล่นตลอดกาลในลักษณะต่อไปนี้

PlayerId : 1843159180 PlayerName : Player 87 Score : 998,955 Timestamp : 2016-03-23
PlayerId : 61891198 PlayerName : Player 19 Score : 998,720 Timestamp : 2016-03-26
PlayerId : 340906298 PlayerName : Player 48 Score : 993,302 Timestamp : 2015-08-27
PlayerId : 541473117 PlayerName : Player 22 Score : 991,368 Timestamp : 2018-04-30
PlayerId : 857460496 PlayerName : Player 68 Score : 988,010 Timestamp : 2015-05-25
PlayerId : 1826646419 PlayerName : Player 91 Score : 984,022 Timestamp : 2016-11-26
PlayerId : 1002199735 PlayerName : Player 35 Score : 982,933 Timestamp : 2015-09-26
PlayerId : 2002563755 PlayerName : Player 23 Score : 979,041 Timestamp : 2016-10-25
PlayerId : 1377548191 PlayerName : Player 2 Score : 978,632 Timestamp : 2016-05-02
PlayerId : 1358098565 PlayerName : Player 65 Score : 973,257 Timestamp : 2016-10-30

ตอนนี้เราจะเรียกใช้คำสั่ง query ที่มีอาร์กิวเมนต์ที่จำเป็นเพื่อค้นหา "Top Ten" ผู้เล่นแห่งปีด้วยการระบุ "ช่วงเวลา" เท่ากับจำนวนชั่วโมงใน 1 ปีซึ่งเท่ากับ 8760 อย่าลืมแทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ที่คุณสร้างในตอนต้นของ Codelab นี้

dotnet run query PROJECT_ID cloudspanner-leaderboard leaderboard 8760

คุณควรจะเห็นการตอบกลับที่มี "สูงสุด 10 อันดับแรก" ผู้เล่นแห่งปีดังต่อไปนี้

PlayerId : 541473117 PlayerName : Player 22 Score : 991,368 Timestamp : 2018-04-30
PlayerId : 228469898 PlayerName : Player 82 Score : 967,177 Timestamp : 2018-01-26
PlayerId : 1131343000 PlayerName : Player 26 Score : 944,725 Timestamp : 2017-05-26
PlayerId : 396780730 PlayerName : Player 41 Score : 929,455 Timestamp : 2017-09-26
PlayerId : 61891198 PlayerName : Player 19 Score : 921,251 Timestamp : 2018-05-01
PlayerId : 634269851 PlayerName : Player 54 Score : 909,379 Timestamp : 2017-07-24
PlayerId : 821111159 PlayerName : Player 55 Score : 908,402 Timestamp : 2017-05-25
PlayerId : 228469898 PlayerName : Player 82 Score : 889,040 Timestamp : 2017-12-26
PlayerId : 1408782275 PlayerName : Player 27 Score : 874,124 Timestamp : 2017-09-24
PlayerId : 1002199735 PlayerName : Player 35 Score : 864,758 Timestamp : 2018-04-24

คราวนี้ลองเรียกใช้คำสั่ง query เพื่อค้นหา "ท็อป 10" กัน ผู้เล่นของเดือนโดยระบุ "ช่วงเวลา" เท่ากับจำนวนชั่วโมงในหนึ่งเดือน ซึ่งก็คือ 730 อย่าลืมแทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ที่คุณสร้างในตอนต้นของ Codelab นี้

dotnet run query PROJECT_ID cloudspanner-leaderboard leaderboard 730

คุณควรจะเห็นการตอบกลับที่มี "สูงสุด 10 อันดับแรก" ผู้เล่นประจำเดือนดังต่อไปนี้

PlayerId : 541473117 PlayerName : Player 22 Score : 991,368 Timestamp : 2018-04-30
PlayerId : 61891198 PlayerName : Player 19 Score : 921,251 Timestamp : 2018-05-01
PlayerId : 1002199735 PlayerName : Player 35 Score : 864,758 Timestamp : 2018-04-24
PlayerId : 1228490432 PlayerName : Player 11 Score : 682,033 Timestamp : 2018-04-26
PlayerId : 648239230 PlayerName : Player 92 Score : 653,895 Timestamp : 2018-05-02
PlayerId : 70762849 PlayerName : Player 77 Score : 598,074 Timestamp : 2018-04-22
PlayerId : 1671215342 PlayerName : Player 62 Score : 506,770 Timestamp : 2018-04-28
PlayerId : 1208850523 PlayerName : Player 21 Score : 216,008 Timestamp : 2018-04-30
PlayerId : 1587692674 PlayerName : Player 63 Score : 188,157 Timestamp : 2018-04-25
PlayerId : 992391797 PlayerName : Player 37 Score : 167,175 Timestamp : 2018-04-30

คราวนี้ลองเรียกใช้คำสั่ง query เพื่อค้นหา "ท็อป 10" กัน ผู้เล่นประจำสัปดาห์โดยการระบุ "ช่วงเวลา" เท่ากับจำนวนชั่วโมงใน 1 สัปดาห์ ซึ่งก็คือ 168 ชั่วโมง อย่าลืมแทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ที่คุณสร้างในตอนต้นของ Codelab นี้

dotnet run query PROJECT_ID cloudspanner-leaderboard leaderboard 168

คุณควรจะเห็นการตอบกลับที่มี "สูงสุด 10 อันดับแรก" ผู้เล่นประจำสัปดาห์ดังต่อไปนี้

PlayerId : 541473117 PlayerName : Player 22 Score : 991,368 Timestamp : 2018-04-30
PlayerId : 61891198 PlayerName : Player 19 Score : 921,251 Timestamp : 2018-05-01
PlayerId : 228469898 PlayerName : Player 82 Score : 853,602 Timestamp : 2018-04-28
PlayerId : 1131343000 PlayerName : Player 26 Score : 695,318 Timestamp : 2018-04-30
PlayerId : 1228490432 PlayerName : Player 11 Score : 682,033 Timestamp : 2018-04-26
PlayerId : 1408782275 PlayerName : Player 27 Score : 671,827 Timestamp : 2018-04-27
PlayerId : 648239230 PlayerName : Player 92 Score : 653,895 Timestamp : 2018-05-02
PlayerId : 816861444 PlayerName : Player 83 Score : 622,277 Timestamp : 2018-04-27
PlayerId : 162043954 PlayerName : Player 75 Score : 572,634 Timestamp : 2018-05-02
PlayerId : 1671215342 PlayerName : Player 62 Score : 506,770 Timestamp : 2018-04-28

เยี่ยมมาก

เมื่อคุณเพิ่มระเบียนแล้ว Spanner จะปรับขนาดฐานข้อมูลเป็นขนาดที่คุณต้องการ

ไม่ว่าฐานข้อมูลของคุณจะเติบโตมากเพียงใด ลีดเดอร์บอร์ดของเกมก็สามารถปรับขนาดได้ด้วยความแม่นยำด้วย Spanner และเทคโนโลยี Truetime

7. ล้างข้อมูล

หลังจากสนุกไปกับการเล่น Spanner แล้ว เราจำเป็นต้องทำความสะอาดสนามเด็กเล่นของเรา ซึ่งช่วยประหยัดทรัพยากรและเงินอันมีค่า โชคดีที่ขั้นตอนนี้เป็นขั้นตอนที่ง่าย เพียงแค่ไปที่ Play Console และลบอินสแตนซ์ที่เราสร้างในขั้นตอน Codelab ที่ชื่อว่า "Setup a Cloud Spannerอินสแตนซ์"

8. ยินดีด้วย

หัวข้อที่ครอบคลุมมีดังนี้

  • อินสแตนซ์ ฐานข้อมูล และสคีมาตารางของ Google Cloud Spanner สำหรับลีดเดอร์บอร์ด
  • วิธีสร้างแอปพลิเคชันคอนโซล .NET Core C#
  • วิธีสร้างฐานข้อมูลและตาราง Spanner โดยใช้ไลบรารีของไคลเอ็นต์ C#
  • วิธีโหลดข้อมูลลงในฐานข้อมูล Spanner โดยใช้ไลบรารีของไคลเอ็นต์ C#
  • วิธีค้นหา "10 อันดับแรก" ผลลัพธ์จากข้อมูลของคุณโดยใช้การประทับเวลาการคอมมิต Spanner และไลบรารีของไคลเอ็นต์ C#

ขั้นตอนถัดไป:

แสดงความคิดเห็น

  • โปรดสละเวลาสักครู่เพื่อทำแบบสำรวจสั้นๆ ของเรา