SearchIndexer 類別

表示索引子。

必須填入所有必要的參數,才能傳送至 Azure。

繼承
azure.search.documents.indexes._generated._serialization.Model
SearchIndexer

建構函式

SearchIndexer(*, name: str, data_source_name: str, target_index_name: str, description: str | None = None, skillset_name: str | None = None, schedule: _models.IndexingSchedule | None = None, parameters: _models.IndexingParameters | None = None, field_mappings: List[_models.FieldMapping] | None = None, output_field_mappings: List[_models.FieldMapping] | None = None, is_disabled: bool = False, e_tag: str | None = None, encryption_key: _models.SearchResourceEncryptionKey | None = None, **kwargs: Any)

僅限關鍵字參數

名稱 Description
name
str

索引子的名稱。 必要。

description
str

索引子的描述。

data_source_name
str

這個索引子從中讀取資料的資料來源名稱。 必要。

skillset_name
str

使用此索引子執行的技能集名稱。

target_index_name
str

這個索引子寫入資料的索引名稱。 必要。

schedule
<xref:search_service_client.models.IndexingSchedule>

這個索引子的排程。

parameters
<xref:search_service_client.models.IndexingParameters>

索引子執行的參數。

field_mappings
list[<xref:search_service_client.models.FieldMapping>]

定義資料來源中的欄位與索引中對應的目標欄位之間的對應。

output_field_mappings
list[<xref:search_service_client.models.FieldMapping>]

輸出欄位對應會在擴充之後套用,並在編制索引之前立即套用。

is_disabled

值,指出索引子是否已停用。 預設值為 false。

e_tag
str

索引子的 ETag。

encryption_key
<xref:search_service_client.models.SearchResourceEncryptionKey>

您在 Azure 金鑰保存庫中建立的加密金鑰描述。 此金鑰可用來為索引子定義提供額外的待用加密層級 (,以及當您想要完全保證沒有任何人甚至 Microsoft 無法解密時,索引子執行狀態) 。 加密索引子定義之後,它一律會保持加密狀態。 搜尋服務會忽略將此屬性設定為 Null 的嘗試。 如果您想要輪替加密金鑰,您可以視需要變更此屬性;您的索引子定義 (和索引子執行狀態) 將不會受到影響。 使用客戶管理的金鑰加密不適用於免費搜尋服務,而且僅適用于在 2019 年 1 月 1 日或之後建立的付費服務。

變數

名稱 Description
name
str

索引子的名稱。 必要。

description
str

索引子的描述。

data_source_name
str

這個索引子從中讀取資料的資料來源名稱。 必要。

skillset_name
str

使用此索引子執行的技能集名稱。

target_index_name
str

這個索引子寫入資料的索引名稱。 必要。

schedule
<xref:search_service_client.models.IndexingSchedule>

這個索引子的排程。

parameters
<xref:search_service_client.models.IndexingParameters>

索引子執行的參數。

field_mappings
list[<xref:search_service_client.models.FieldMapping>]

定義資料來源中的欄位與索引中對應的目標欄位之間的對應。

output_field_mappings
list[<xref:search_service_client.models.FieldMapping>]

輸出欄位對應會在擴充之後套用,並在編制索引之前立即套用。

is_disabled

值,指出索引子是否已停用。 預設值為 false。

e_tag
str

索引子的 ETag。

encryption_key
<xref:search_service_client.models.SearchResourceEncryptionKey>

您在 Azure 金鑰保存庫中建立的加密金鑰描述。 此金鑰可用來為索引子定義提供額外的待用加密層級 (,以及當您想要完全保證沒有任何人甚至 Microsoft 無法解密時,索引子執行狀態) 。 加密索引子定義之後,它一律會保持加密狀態。 搜尋服務會忽略將此屬性設定為 Null 的嘗試。 如果您想要輪替加密金鑰,您可以視需要變更此屬性;您的索引子定義 (和索引子執行狀態) 將不會受到影響。 使用客戶管理的金鑰加密不適用於免費搜尋服務,而且僅適用于在 2019 年 1 月 1 日或之後建立的付費服務。

方法

as_dict

傳回可使用 json.dump 序列化的聽寫。

進階用法可以選擇性地使用回呼作為參數:

索引鍵是 Python 中使用的屬性名稱。 Attr_desc是中繼資料的聽寫。 目前包含具有 msrest 類型的 'type',以及具有 RestAPI 編碼金鑰的 'key'。 Value 是這個 物件中的目前值。

傳回的字串將用來序列化索引鍵。 如果傳回類型是清單,則會將此視為階層式結果聽寫。

請參閱此檔案中的三個範例:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

如果您想要 XML 序列化,您可以傳遞 kwargs is_xml=True。

deserialize

使用 RestAPI 語法剖析 str 並傳回模型。

enable_additional_properties_sending
from_dict

使用指定的索引鍵擷取器剖析聽寫會傳回模型。

根據預設,請考慮金鑰擷取器 (rest_key_case_insensitive_extractor、attribute_key_case_insensitive_extractor和last_rest_key_case_insensitive_extractor)

is_xml_model
serialize

傳回會從此模型傳送至伺服器的 JSON。

這是as_dict (full_restapi_key_transformer的別名 ,keep_readonly=False)

如果您想要 XML 序列化,您可以傳遞 kwargs is_xml=True。

as_dict

傳回可使用 json.dump 序列化的聽寫。

進階用法可以選擇性地使用回呼作為參數:

索引鍵是 Python 中使用的屬性名稱。 Attr_desc是中繼資料的聽寫。 目前包含具有 msrest 類型的 'type',以及具有 RestAPI 編碼金鑰的 'key'。 Value 是這個 物件中的目前值。

傳回的字串將用來序列化索引鍵。 如果傳回類型是清單,則會將此視為階層式結果聽寫。

請參閱此檔案中的三個範例:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

如果您想要 XML 序列化,您可以傳遞 kwargs is_xml=True。

as_dict(keep_readonly: bool = True, key_transformer: ~typing.Callable[[str, ~typing.Dict[str, ~typing.Any], ~typing.Any], ~typing.Any] = <function attribute_transformer>, **kwargs: ~typing.Any) -> MutableMapping[str, Any]

參數

名稱 Description
key_transformer
<xref:function>

按鍵轉換程式函式。

keep_readonly
預設值: True

傳回

類型 Description

聽寫 JSON 相容物件

deserialize

使用 RestAPI 語法剖析 str 並傳回模型。

deserialize(data: Any, content_type: str | None = None) -> ModelType

參數

名稱 Description
data
必要
str

使用 RestAPI 結構的 str。 根據預設,JSON。

content_type
str

根據預設,如果 XML,請設定 application/xml。

預設值: None

傳回

類型 Description

此模型的實例

例外狀況

類型 Description
DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending() -> None

from_dict

使用指定的索引鍵擷取器剖析聽寫會傳回模型。

根據預設,請考慮金鑰擷取器 (rest_key_case_insensitive_extractor、attribute_key_case_insensitive_extractor和last_rest_key_case_insensitive_extractor)

from_dict(data: Any, key_extractors: Callable[[str, Dict[str, Any], Any], Any] | None = None, content_type: str | None = None) -> ModelType

參數

名稱 Description
data
必要

使用 RestAPI 結構的聽寫

content_type
str

根據預設,如果 XML,請設定 application/xml。

預設值: None
key_extractors
預設值: None

傳回

類型 Description

此模型的實例

例外狀況

類型 Description
DeserializationError if something went wrong

is_xml_model

is_xml_model() -> bool

serialize

傳回會從此模型傳送至伺服器的 JSON。

這是as_dict (full_restapi_key_transformer的別名 ,keep_readonly=False)

如果您想要 XML 序列化,您可以傳遞 kwargs is_xml=True。

serialize(keep_readonly: bool = False, **kwargs: Any) -> MutableMapping[str, Any]

參數

名稱 Description
keep_readonly

如果您想要序列化唯讀屬性

預設值: False

傳回

類型 Description

聽寫 JSON 相容物件