আঞ্চলিক এন্ডপয়েন্ট সহ ডেটা লোক্যালিটি কনফিগার করুন

এই পৃষ্ঠায় বর্ণনা করা হয়েছে কীভাবে একটি আঞ্চলিক বা বহু-আঞ্চলিক এন্ডপয়েন্ট ব্যবহার করার জন্য Cloud Firestore ক্লায়েন্ট লাইব্রেরিগুলো কনফিগার করতে হয়।

যখন আপনি Cloud Firestore ক্লায়েন্ট লাইব্রেরি ব্যবহার করেন, তখন আপনি নিম্নলিখিত যেকোনো এন্ডপয়েন্ট ব্যবহার করতে পারেন:

  • গ্লোবাল এন্ডপয়েন্ট : ডিফল্টরূপে, Cloud Firestore ক্লায়েন্ট লাইব্রেরিগুলো firestore.googleapis.com নামের একটি গ্লোবাল সার্ভিস এন্ডপয়েন্টে এপিআই (API) অনুরোধ পাঠায়। এই গ্লোবাল সার্ভিস এন্ডপয়েন্টটি অনুরোধটিকে আপনার ডেটাবেসে রাউট করে। রাউটিংয়ের সময়, একটি অনুরোধ এমন কোনো সার্ভারের মধ্য দিয়ে যেতে পারে যা আপনার ডেটাবেসের অবস্থান থেকে ভিন্ন কোনো স্থানে অবস্থিত।

  • আঞ্চলিক এন্ডপয়েন্ট : একটি আঞ্চলিক এন্ডপয়েন্ট এমন বিধিনিষেধ আরোপ করে যা নিশ্চিত করে যে ডেটা একটি নির্দিষ্ট Google Cloud অঞ্চলে প্রেরণ, সংরক্ষণ এবং প্রক্রিয়াজাত করা হয়। সার্ভিস এন্ডপয়েন্টটি যেন আপনার অ্যাপের Cloud Firestore অনুরোধগুলি আপনার ডেটাবেসের মতো একই অঞ্চলে প্রক্রিয়াজাত করে, তা নিশ্চিত করতে ক্লায়েন্ট লাইব্রেরিতে একটি আঞ্চলিক এন্ডপয়েন্ট নির্দিষ্ট করুন।

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

একটি আঞ্চলিক বা বহু-আঞ্চলিক শেষবিন্দু নির্ধারণ করুন

একটি আঞ্চলিক বা বহু-আঞ্চলিক এন্ডপয়েন্ট কনফিগার করার পদ্ধতি একই: ক্লায়েন্ট লাইব্রেরি ইনিশিয়ালাইজ করার সময় আপনাকে এন্ডপয়েন্ট স্ট্রিংটি প্রদান করতে হবে। নিম্নলিখিত উদাহরণগুলিতে দেখানো হয়েছে কীভাবে একটি আঞ্চলিক এন্ডপয়েন্ট ( firestore.us-central1.rep.googleapis.com ) ব্যবহার করে এন্ডপয়েন্ট স্ট্রিং সেট করতে হয়। একটি বহু-আঞ্চলিক এন্ডপয়েন্ট ব্যবহার করতে, আপনার ডাটাবেসের অবস্থানের সাথে সঙ্গতিপূর্ণ একটি বহু-আঞ্চলিক এন্ডপয়েন্ট স্ট্রিং প্রদান করুন (উদাহরণস্বরূপ, nam5 এর জন্য firestore.us.rep.googleapis.com )।

জাভা 


import com.google.auth.oauth2.GoogleCredentials;
import com.google.cloud.firestore.Firestore;
import com.google.cloud.firestore.FirestoreOptions;


/**
 * Demonstrate how to set a regional endpoint.
 */
public class RegionalEndpointSnippets {

  /**
   * Create a client with a regional endpoint.
   **/
  public Firestore regionalEndpoint(String projectId, String endpoint) throws Exception {
    FirestoreOptions firestoreOptions =
        FirestoreOptions.newBuilder()
            .setProjectId(projectId)
            .setCredentials(GoogleCredentials.getApplicationDefault())
            // set endpoint like firestore.us-central1.rep.googleapis.com:443
            .setHost(endpoint)
            .build();
    Firestore dbWithEndpoint = firestoreOptions.getService();

    return dbWithEndpoint;
  }

}
RegionalEndpointSnippets.java

পাইথন 

ENDPOINT = "firestore.africa-south1.rep.googleapis.com"
client_options = ClientOptions(api_endpoint=ENDPOINT)
db = firestore.Client(client_options=client_options)

cities_query = db.collection("cities").limit(2).get()
for r in cities_query:
    print(r)
snippets.py

আঞ্চলিক এবং বহু-আঞ্চলিক এন্ডপয়েন্ট শব্দার্থবিদ্যা

আঞ্চলিক প্রান্তবিন্দু (REP):

Cloud Firestore Cloud Firestore তালিকাভুক্ত আঞ্চলিক অবস্থানগুলির জন্য আঞ্চলিক এন্ডপয়েন্ট সমর্থন করে।

আঞ্চলিক এন্ডপয়েন্ট নির্ধারণ করতে নিম্নলিখিত বিন্যাসটি ব্যবহার করুন:

জাভা 

  firestore.REGION_NAME.rep.googleapis.com:443

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

পাইথন 

  firestore.REGION_NAME.rep.googleapis.com

যান 

  firestore.REGION_NAME.rep.googleapis.com:443

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

REGION_NAME পরিবর্তে একটি আঞ্চলিক হোস্টনেমের নাম ব্যবহার করুন।

হোস্টনেমের কিছু উদাহরণ হলো:

  • firestore.us-central1.rep.googleapis.com
  • firestore.europe-west1.rep.googleapis.com

বহু-আঞ্চলিক এন্ডপয়েন্ট (MREP)

বহু-আঞ্চলিক এন্ডপয়েন্টের জন্য, nam5 এবং nam7 লোকেশনের ক্ষেত্রে us এবং eur3 লোকেশনের ক্ষেত্রে eu ব্যবহার করুন (দেখুন বহু-আঞ্চলিক লোকেশন )।

জাভা 

  firestore.us.rep.googleapis.com:443
  firestore.eu.rep.googleapis.com:443

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

পাইথন 

  firestore.us.rep.googleapis.com
  firestore.eu.rep.googleapis.com

যান 

  firestore.us.rep.googleapis.com:443
  firestore.eu.rep.googleapis.com:443

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

সীমাবদ্ধতা

অবস্থানগত এন্ডপয়েন্ট (অপ্রচলিত)

অবস্থানভিত্তিক এন্ডপয়েন্ট এখন অপ্রচলিত। এর পরিবর্তে আঞ্চলিক বা বহু-আঞ্চলিক এন্ডপয়েন্ট ব্যবহার করুন।

Cloud Firestore পূর্বে নিম্নলিখিত ফরম্যাটের অবস্থানগত এন্ডপয়েন্ট সমর্থন করত:

জাভা 

  REGION_NAME-firestore.googleapis.com:443

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

পাইথন 

  REGION_NAME-firestore.googleapis.com

যান 

  REGION_NAME-firestore.googleapis.com:443

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

REGION_NAME পরিবর্তে একটি আঞ্চলিক বা বহু-আঞ্চলিক হোস্টনেমের নাম ব্যবহার করুন।

হোস্টনেমের কিছু উদাহরণ হলো:

  • eur3-firestore.googleapis.com
  • nam5-firestore.googleapis.com
  • europe-west6-firestore.googleapis.com
  • asia-northeast2-firestore.googleapis.com

বহু-আঞ্চলিক এবং আঞ্চলিক হোস্টনেমগুলির সম্পূর্ণ তালিকার জন্য, Cloud Firestore অবস্থানসমূহ দেখুন।

গ্লোবাল এপিআই এন্ডপয়েন্ট ব্যবহার সীমাবদ্ধ করুন

আঞ্চলিক এবং বহু-আঞ্চলিক এন্ডপয়েন্টের ব্যবহার কার্যকর করতে, গ্লোবাল এপিআই এন্ডপয়েন্টে পাঠানো অনুরোধ ব্লক করার জন্য constraints/gcp.restrictEndpointUsage অর্গানাইজেশন পলিসি কনস্ট্রেইন্টটি ব্যবহার করুন। আরও তথ্যের জন্য, এন্ডপয়েন্ট ব্যবহার সীমাবদ্ধকরণ (Restricting endpoint usage ) দেখুন।