ক্লাউড স্প্যানার সহ স্প্রিং বুট অ্যাপ্লিকেশন

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

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

তুমি কি শিখবে

  • স্প্রিং বুট ব্যবহার করে ডেটা সংরক্ষণ এবং পুনরুদ্ধার করার জন্য ক্লাউড স্প্যানার কীভাবে ব্যবহার করবেন

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

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

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

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

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

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

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

  1. ক্লাউড কনসোলে সাইন ইন করুন এবং একটি নতুন প্রকল্প তৈরি করুন অথবা বিদ্যমান একটি পুনরায় ব্যবহার করুন। (যদি আপনার ইতিমধ্যেই একটি Gmail বা G Suite অ্যাকাউন্ট না থাকে, তাহলে আপনাকে অবশ্যই একটি তৈরি করতে হবে।)

dMbN6g9RawQj_VXCSYpdYncY-DbaRzr2GbnwoV7jFf1u3avxJtmGPmKpMYgiaMH-qu80a_NJ9p2IIXFppYk8x3wyymZXavjglNLJhuXieCem56H30hwXtd8PvXGpXJO9gEUDu3cZw

ci9Oe6PgnbNuSYlMyvbXF1JdQyiHoEgnhl4PlV_MFagm2ppzhueRkqX4eLjJllZco_2zCp0V0bpTupUSKji9KkQyWqj11pqit1K1faS1V6aFxLpGtQd5Q55

8-tA_Lheyo8SscAVKrGii2coplQp2_D1Iosb2ViABY0UUO1A8cimXUu6Wf1R9zJIRExL5 OB2j946aIiFtyKTzxDcNnuznmR45vZ2HMoK3o67jxuoUJCAnqvEX6NgPGFjCVNgASc-lg

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

  1. এরপর, গুগল ক্লাউড রিসোর্স ব্যবহার করার জন্য আপনাকে ক্লাউড কনসোলে বিলিং সক্ষম করতে হবে।

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

ক্লাউড শেল সক্রিয় করুন

  1. ক্লাউড কনসোল থেকে, ক্লাউড শেল সক্রিয় করুন ক্লিক করুন H7JlbhKGHITmsxhQIcLwoe5HXZMhDlYue4K-SPszMxUxDjIeWfOHBfxDHYpmLQTzUmQ7Xx8o6OJUlANnQF0iBuUyfp1RzVad_4nCa0Zz5LtwBlUZFXFCWFrmrWZLqg1MkZz2LdgUDQ .

zlNW0HehB_AFW1qZ4AyebSQUdWm95n7TbnOr7UVm3j9dFcg6oWApJRlC0jnU1Mvb-IQp-trP1Px8xKNwt6o3pP6fyih947sEhOFI4IRF0W7WZk6hFqZDUGXQQXrw21GuMm2ecHrbzQ

যদি আপনি আগে কখনও ক্লাউড শেল শুরু না করে থাকেন, তাহলে আপনাকে একটি মধ্যবর্তী স্ক্রিন (ভাঁজের নীচে) দেখানো হবে যেখানে এটি কী তা বর্ণনা করা হবে। যদি তাই হয়, তাহলে Continue এ ক্লিক করুন (এবং আপনি এটি আর কখনও দেখতে পাবেন না)। এই এককালীন স্ক্রিনটি কেমন দেখাবে:

kEPbNAo_w5C_pi9QvhFwWwky1cX8hr_xEMGWySNIoMCdi-Djx9AQRqWn-__DmEpC7vKgUtl-feTcv-wBxJ8NwzzAp7mY65-fi2LJo4twUoewT1SUjd6Y3h81RG3rKIkqhoVlFR-G7w

ক্লাউড শেলের সাথে সংযোগ স্থাপন এবং সংযোগ স্থাপন করতে মাত্র কয়েক মুহূর্ত সময় লাগবে।

pTv5mEKzWMWp5VBrg2eGcuRPv9dLInPToS-mohlrqDASyYGWnZ_SwE-MzOWHe76ZdCSmw0kgWogSJv27lrQE8pvA5OD6P1I47nz8vrAdK7yR1NseZKJvcxAZrPb8wRxoqyTpD-gbhA

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

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

  1. আপনি প্রমাণিত কিনা তা নিশ্চিত করতে ক্লাউড শেলে নিম্নলিখিত কমান্ডটি চালান: 
gcloud auth list

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

 Credentialed Accounts
ACTIVE  ACCOUNT
*       <my_account>@<my_domain.com>

To set the active account, run:
    $ gcloud config set account `ACCOUNT`

gcloud config list project

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

[core]
project = <PROJECT_ID>

যদি তা না হয়, তাহলে আপনি এই কমান্ড দিয়ে এটি সেট করতে পারেন:

gcloud config set project <PROJECT_ID>

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

Updated property [core/project].

৩. ক্লাউড স্প্যানার আরম্ভ করুন

gcloud CLI ব্যবহার করে Cloud Spanner API সক্ষম করুন:

gcloud services enable spanner.googleapis.com

একটি ক্লাউড স্প্যানার ইনস্ট্যান্স তৈরি করুন:

gcloud spanner instances create spanner-instance \
 --config=regional-us-central1 \
 --nodes=1 --description="A Spanner Instance"

ইনস্ট্যান্সের মধ্যে একটি ডাটাবেস তৈরি করুন:

gcloud spanner databases create orders \
  --instance=spanner-instance

ডেটা স্কিমা বর্ণনা করার জন্য একটি schema.ddl ফাইল তৈরি করুন: 

cat << EOF > schema.ddl
CREATE TABLE orders (
  order_id STRING(36) NOT NULL,
  description STRING(255),
  creation_timestamp TIMESTAMP,
) PRIMARY KEY (order_id);

CREATE TABLE order_items (
  order_id STRING(36) NOT NULL,
  order_item_id STRING(36) NOT NULL,
  description STRING(255),
  quantity INT64,
) PRIMARY KEY (order_id, order_item_id),
  INTERLEAVE IN PARENT orders ON DELETE CASCADE;
EOF

ক্লাউড স্প্যানার ডাটাবেসে স্কিমা প্রয়োগ করুন: 

gcloud spanner databases ddl update orders \
  --instance=spanner-instance \
  --ddl="$(<schema.ddl)"

৪. একটি নতুন স্প্রিং বুট জাভা অ্যাপ্লিকেশন বুটস্ট্র্যাপ করুন

ক্লাউড শেল পরিবেশ থেকে, একটি নতুন স্প্রিং বুট অ্যাপ্লিকেশন শুরু এবং বুটস্ট্র্যাপ করতে নিম্নলিখিত কমান্ডটি ব্যবহার করুন: 

$ curl https://start.spring.io/starter.tgz \
  -d packaging=jar \
  -d dependencies=cloud-gcp,web,lombok \
  -d baseDir=spanner-example \
  -d type=maven-project \
  -d bootVersion=3.2.6 | tar -xzvf -

$ cd spanner-example

এটি একটি নতুন Maven প্রকল্পের সাথে একটি নতুন spanner-example/ ডিরেক্টরি তৈরি করবে, Maven এর pom.xml , একটি Maven র‍্যাপার, এবং একটি অ্যাপ্লিকেশন এন্ট্রিপয়েন্ট সহ।

pom.xml ফাইলে, স্প্রিং ডেটা ক্লাউড স্প্যানার স্টার্টার যোগ করুন।

স্প্যানার-উদাহরণ/pom.xml 

<project>
  ...
  <dependencies>
        ...
        <!-- Add Spring Cloud GCP Spanner Starter -->
        <dependency>
                <groupId>com.google.cloud</groupId>
                <artifactId>spring-cloud-gcp-starter-data-spanner</artifactId>
        </dependency>

        ...

  </dependencies>

  ...
</project>

application.properties-এ, Spanner ডাটাবেস সংযোগ তথ্য কনফিগার করুন:

স্প্যানার-উদাহরণ/src/main/resources/application.properties 

spring.cloud.gcp.spanner.instance-id=spanner-instance
spring.cloud.gcp.spanner.database=orders

নিশ্চিত করুন যে JAVA_HOME সঠিক সংস্করণে সেট করা আছে: 

export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64/

আপনার Maven কনফিগারেশন সঠিক কিনা তা নিশ্চিত করতে অ্যাপটি পুনর্নির্মাণ করুন: 

./mvnw package

৫. সত্তা তৈরি করুন

স্প্রিং ক্লাউড জিসিপির স্প্রিং ডেটা স্প্যানার সাপোর্টের সাহায্যে, আপনি স্প্রিং ডেটা ব্যবহার করে সহজেই একটি জাভা অবজেক্ট তৈরি করতে পারেন এবং স্প্যানার টেবিলে ইডিওম্যাটিক ORM ম্যাপিং করতে পারেন।

প্রথমে, একটি অর্ডার আইটেম ক্লাস তৈরি করুন।

স্প্যানার-উদাহরণ/src/main/java/com/example/demo/OrderItem.java 

package com.example.demo;

import com.google.cloud.spring.data.spanner.core.mapping.Column;
import com.google.cloud.spring.data.spanner.core.mapping.PrimaryKey;
import com.google.cloud.spring.data.spanner.core.mapping.Table;

@Table(name="order_items")
@Data
class OrderItem {
  @PrimaryKey(keyOrder = 1)
  @Column(name="order_id")
  private String orderId;

  @PrimaryKey(keyOrder = 2)
  @Column(name="order_item_id")
  private String orderItemId;

  private String description;
  private Long quantity;
}

স্প্যানারে পিতামাতা/শিশু সম্পর্কের জন্য, আপনার একটি কম্পোজিট প্রাইমারি কী ব্যবহার করা উচিত। এই উদাহরণে, কম্পোজিট কী হল order_id , এবং order_item_id ।

এরপর, একটি অর্ডার ক্লাস তৈরি করুন:

স্প্যানার-উদাহরণ/src/main/java/com/example/demo/Order.java 

package com.example.demo;

import java.time.LocalDateTime;
import java.util.List;
import lombok.Data;
import com.google.cloud.spring.data.spanner.core.mapping.Column;
import com.google.cloud.spring.data.spanner.core.mapping.Interleaved;
import com.google.cloud.spring.data.spanner.core.mapping.PrimaryKey;
import com.google.cloud.spring.data.spanner.core.mapping.Table;

@Table(name="orders")
@Data
public class Order {
  @PrimaryKey
  @Column(name="order_id")
  private String id;

  private String description;

  @Column(name="creation_timestamp")
  private LocalDateTime timestamp;

  @Interleaved
  private List<OrderItem> items;
}

এই ক্লাসটি @Interleaved অ্যানোটেশন ব্যবহার করে অর্ডার আইটেমের সাথে এক থেকে বহু সম্পর্ক তৈরি করে।

৬. OrderRepository ইন্টারফেস তৈরি করুন

নিম্নলিখিত কন্টেন্ট দিয়ে OrderRepository ক্লাস তৈরি করুন:

স্প্যানার-উদাহরণ/src/main/java/com/example/demo/OrderRepository.java 

package com.example.demo;

import com.google.cloud.spring.data.spanner.repository.SpannerRepository;
import org.springframework.stereotype.Repository;

@Repository
public interface OrderRepository extends SpannerRepository<Order, String> {
}

ইন্টারফেসটি SpannerRepository<Order, String> পর্যন্ত প্রসারিত করে যেখানে Order হল ডোমেইন ক্লাস এবং String হল Primary Key টাইপ। Spring Data স্বয়ংক্রিয়ভাবে এই ইন্টারফেসের মাধ্যমে CRUD অ্যাক্সেস প্রদান করবে এবং আপনাকে কোনও অতিরিক্ত কোড তৈরি করতে হবে না।

৭. মৌলিক ক্রিয়াকলাপের জন্য একটি REST কন্ট্রোলার তৈরি করুন

প্রধান অ্যাপ্লিকেশন DemoApplication ক্লাসটি খুলুন এবং এটিকে এইরকম দেখতে পরিবর্তন করুন:

স্প্যানার-উদাহরণ/src/main/java/com/example/demo/DemoApplication.java 

package com.example.demo;

import java.time.LocalDateTime;
import java.util.UUID;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.server.ResponseStatusException;

@SpringBootApplication
public class DemoApplication {
        public static void main(String[] args) {
                SpringApplication.run(DemoApplication.class, args);
        }
}

@RestController
class OrderController {
  private final OrderRepository orderRepository;

        OrderController(OrderRepository orderRepository) {
                this.orderRepository = orderRepository;
        }

        @GetMapping("/api/orders/{id}")
        public Order getOrder(@PathVariable String id) {
          return orderRepository.findById(id)
                                .orElseThrow(() -> new ResponseStatusException(HttpStatus.NOT_FOUND, id + " not found"));
        }

        @PostMapping("/api/orders")
        public String createOrder(@RequestBody Order order) {
                // Spanner currently does not auto generate IDs
                // Generate UUID on new orders
                order.setId(UUID.randomUUID().toString());
                order.setTimestamp(LocalDateTime.now());

                order.getItems().forEach(item -> {
                        // Assign parent ID, and also generate child ID
                        item.setOrderId(order.getId());
                        item.setOrderItemId(UUID.randomUUID().toString());
                });

          Order saved = orderRepository.save(order);
          return saved.getId();
        }
}

৮. অ্যাপ্লিকেশনটি চালান

অ্যাপ্লিকেশনটি পুনর্নির্মাণ করুন এবং চালান! 

./mvnw spring-boot:run

এটি সঠিকভাবে শুরু হওয়া উচিত এবং পোর্ট 8080 এ শোনা উচিত।

আপনি এন্ডপয়েন্টে একটি অর্ডার রেকর্ড পোস্ট করতে পারেন: 

curl -H"Content-Type: application/json" -d'{"description": "My orders", "items": [{"description": "Android Phone", "quantity": "1"}]}' \
  http://localhost:8080/api/orders

এটির অর্ডারের UUID দিয়ে সাড়া দেওয়া উচিত।

তারপর আপনি UUID দিয়ে অর্ডারটি পুনরুদ্ধার করতে পারেন: 

curl http://localhost:8080/api/orders/REPLACE_WITH_ORDER_UUID

ক্লাউড স্প্যানারে ডেটা কীভাবে সংরক্ষণ করা হয় তা দেখতে, ক্লাউড কনসোলে যান এবং স্প্যানার → স্প্যানার ইনস্ট্যান্স → অর্ডার ডাটাবেস → অর্ডার টেবিল → ডেটা এ নেভিগেট করুন।

780f4947e4a864f6.png সম্পর্কে

9. পরিষ্কার করা

পরিষ্কার করার জন্য, স্প্যানার ইনস্ট্যান্সটি মুছে ফেলুন যাতে এটি আর চার্জ না নেয়! 

gcloud spanner instances delete spanner-instance -q

১০. অভিনন্দন!

এই কোডল্যাবে, আপনি একটি ইন্টারেক্টিভ CLI অ্যাপ্লিকেশন তৈরি করেছেন যা ক্লাউড স্প্যানার থেকে ডেটা সংরক্ষণ এবং পুনরুদ্ধার করতে পারে!

আরও জানুন

লাইসেন্স

এই কাজটি ক্রিয়েটিভ কমন্স অ্যাট্রিবিউশন ২.০ জেনেরিক লাইসেন্সের অধীনে লাইসেন্সপ্রাপ্ত।