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

এই পৃষ্ঠাটি বর্ণনা করে যে কীভাবে 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;
  }

}

পাইথন

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)

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

আঞ্চলিক শেষ বিন্দু (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 অবস্থানগুলি দেখুন।

বিশ্বব্যাপী API এন্ডপয়েন্ট ব্যবহার সীমিত করুন

আঞ্চলিক এবং বহু-আঞ্চলিক এন্ডপয়েন্টের ব্যবহার জোরদার করতে, গ্লোবাল API এন্ডপয়েন্টের অনুরোধ ব্লক করতে constraints/gcp.restrictEndpointUsage organization policy constraints ব্যবহার করুন। আরও তথ্যের জন্য, endpoint ব্যবহার সীমাবদ্ধ করা দেখুন।