REST Resource: projects.databases.collectionGroups.fields

संसाधन: फ़ील्ड

डेटाबेस में एक फ़ील्ड को दिखाता है.

फ़ील्ड को उनके "कलेक्शन ग्रुप" के हिसाब से ग्रुप में बांटा जाता है, जो डेटाबेस में एक ही आईडी वाले सभी कलेक्शन को दिखाते हैं.

JSON के काेड में दिखाना
{
  "name": string,
  "indexConfig": {
    object (IndexConfig)
  },
  "ttlConfig": {
    object (TtlConfig)
  }
}
फ़ील्ड
name

string

ज़रूरी है. projects/{projectId}/databases/{databaseId}/collectionGroups/{collectionId}/fields/{fieldPath} फ़ॉर्म का फ़ील्ड नाम

फ़ील्ड पाथ, कोई सामान्य फ़ील्ड नाम हो सकता है , जैसे कि address या MapValue में मौजूद फ़ील्ड का पाथ, जैसे कि address.city या कोई खास फ़ील्ड पाथ. सिर्फ़ * खास फ़ील्ड ही मान्य है. यह किसी भी फ़ील्ड के बारे में बताता है.

फ़ील्ड पाथ को (backtick). The only character that needs to be escaped within a quoted field path is the backtick character itself, escaped using a backslash. Special characters in field paths that must be quoted include:*,., ``` (backtick),[,]` और किसी ASCII (ASCII) सिम्बॉलिक वर्णों का इस्तेमाल करके कोट किया जा सकता है.

उदाहरण: (ध्यान दें: यहां टिप्पणियां मार्कडाउन सिंटैक्स में लिखी जाती हैं, इसलिए कोड ब्लॉक को दिखाने के लिए बैकटिक की एक अतिरिक्त लेयर होती है) \address.city`represents a field namedaddress.city, not the map key शहरin the fieldपता. `*`represents a field named*`, इसमें कोई फ़ील्ड नहीं होता.

खास Field में, सभी फ़ील्ड को इंडेक्स करने की डिफ़ॉल्ट सेटिंग होती हैं. इस फ़ील्ड के संसाधन का नाम यह है: projects/{projectId}/databases/{databaseId}/collectionGroups/__default__/fields/* इस Field में तय किए गए इंडेक्स, उन सभी फ़ील्ड पर लागू किए जाएंगे जिनमें अपना Field इंडेक्स कॉन्फ़िगरेशन नहीं है.

indexConfig

object (IndexConfig)

इस फ़ील्ड के लिए इंडेक्स कॉन्फ़िगरेशन. अगर नीति को सेट नहीं किया जाता है, तो फ़ील्ड इंडेक्स करने की सुविधा, ancestorField के तय किए गए कॉन्फ़िगरेशन पर वापस लागू हो जाएगी. इस फ़ील्ड के सभी इंडेक्स साफ़ तौर पर हटाने के लिए, इंडेक्स की खाली सूची के साथ कोई इंडेक्स कॉन्फ़िगरेशन तय करें.

ttlConfig

object (TtlConfig)

इस Field के लिए TTL कॉन्फ़िगरेशन. इसे सेट करने या अनसेट करने से, उन दस्तावेज़ों के लिए TTL चालू या बंद हो जाएगा जिनमें यह Field है.

इंडेक्स कॉन्फ़िगरेशन

इस फ़ील्ड के लिए इंडेक्स कॉन्फ़िगरेशन.

JSON के काेड में दिखाना
{
  "indexes": [
    {
      object (Index)
    }
  ],
  "usesAncestorConfig": boolean,
  "ancestorField": string,
  "reverting": boolean
}
फ़ील्ड
indexes[]

object (Index)

इस फ़ील्ड के लिए इस्तेमाल किए जा सकने वाले इंडेक्स.

usesAncestorConfig

boolean

सिर्फ़ आउटपुट के लिए. सही होने पर, Field के इंडेक्स कॉन्फ़िगरेशन को ancestorField में बताए गए कॉन्फ़िगरेशन से सेट किया जाता है. गलत होने पर, Field के इंडेक्स कॉन्फ़िगरेशन को साफ़ तौर पर बताया जाता है.

ancestorField

string

सिर्फ़ आउटपुट के लिए. यह नीति उस Field के संसाधन का नाम बताती है जिससे इस फ़ील्ड का इंडेक्स कॉन्फ़िगरेशन सेट किया गया है (जब usesAncestorConfig सही हो). इसके अलावा, अगर इस फ़ील्ड में कोई इंडेक्स कॉन्फ़िगरेशन नहीं था (जब usesAncestorConfig गलत है), तो इस फ़ील्ड में इसे सेट किया जाएगा.

reverting

boolean

सही होने पर सिर्फ़ आउटपुट दिखाता है, लेकिन Field का इंडेक्स कॉन्फ़िगरेशन पहले जैसा किया जा रहा है. एक बार पूरा हो जाने पर, इंडेक्स कॉन्फ़िगरेशन उसी स्थिति में बदल जाएगा जिस स्थिति में ancestorField के ज़रिए दर्ज फ़ील्ड शामिल है, जिस समय usesAncestorConfig true और reverting false होगा.

TtlConfig

उन दस्तावेज़ों के लिए TTL (टाइम-टू-लाइव) कॉन्फ़िगरेशन जिनमें यह Field सेट है.

टाइमस्टैंप की वैल्यू को TTL की सुविधा वाले फ़ील्ड में स्टोर करना, दस्तावेज़ के खत्म होने का पूरा समय माना जाएगा. पुराने टाइमस्टैंप की वैल्यू से पता चलता है कि दस्तावेज़ की समयसीमा, तुरंत खत्म होने की ज़रूरी शर्तें पूरी करती है. किसी अन्य तरह के डेटा का इस्तेमाल करने या फ़ील्ड को खाली छोड़ देने से, हर दस्तावेज़ के लिए समयसीमा खत्म होने की सुविधा बंद हो जाएगी.

JSON के काेड में दिखाना
{
  "state": enum (State)
}
फ़ील्ड
state

enum (State)

सिर्फ़ आउटपुट के लिए. TTL कॉन्फ़िगरेशन की स्थिति.

राज्य

सभी दस्तावेज़ों पर TTL कॉन्फ़िगरेशन लागू करने की स्थिति.

एनम्स
STATE_UNSPECIFIED स्थिति की जानकारी नहीं है या इसकी जानकारी नहीं है.
CREATING TTL लागू किया जा रहा है. बदलाव को ट्रैक करने के लिए, लंबे समय से चल रही कार्रवाई चालू है. लिखे गए नए दस्तावेज़ों में अनुरोध के मुताबिक TTL (टीटीएल) लागू किए जाएंगे. मौजूदा दस्तावेज़ों पर जिन TTLs का अनुरोध किया गया है उन्हें अब भी प्रोसेस किया जा रहा है. सभी मौजूदा दस्तावेज़ों के TTLs प्रोसेस हो जाने के बाद, स्थिति 'ACTIVE' हो जाएगी.
ACTIVE TTL सभी दस्तावेज़ों के लिए चालू है.
NEEDS_REPAIR TTL कॉन्फ़िगरेशन सभी मौजूदा दस्तावेज़ों के लिए चालू नहीं किया जा सका. नए लिखे गए दस्तावेज़ों पर TTL (टीटीएल) लागू होगा. पिछली बार इस Field के लिए TTL चालू करने की कोशिश करते समय LRO वापस लौट आया था, और इसमें ज़्यादा जानकारी हो सकती है.

तरीके

get

इसकी मदद से, फ़ील्ड के लिए मेटाडेटा और कॉन्फ़िगरेशन की जानकारी मिलती है.

list

इस डेटाबेस के लिए फ़ील्ड कॉन्फ़िगरेशन और मेटाडेटा की जानकारी देता है.

patch

फ़ील्ड कॉन्फ़िगरेशन को अपडेट करता है.