從 Azure SQL 資料庫編製數據的索引

發行項
11/23/2024

在本文中，了解如何設定索引子，以從 Azure SQL Database 或 Azure SQL 受控執行個體匯入內容，並在 Azure AI 搜尋服務中可供搜尋。

本文提供 Azure SQL 的特定資訊，用於補充建立索引子。它會使用 Azure 入口網站和 REST API 來示範所有索引器通用的三部分工作流程：建立數據源、建立索引、建立索引器。提交建立索引子要求時會擷取資料。

本文也提供下列項目：

描述 Azure SQL 索引子所支援的變更偵測原則，以便設定累加式索引編制。
常見問題集 (FAQ) 一節，針對功能相容性問題提供解答。

注意

索引子無法進行即時資料同步處理。索引子最多可以每隔五分鐘重新編製資料表的索引。如果資料更新必須盡快反映在索引中，建議您直接推送更新的資料列。

必要條件

以單一資料表或檢視表提供資料的 Azure SQL 資料庫或具有公用端點的 SQL 受控執行個體。

若您擁有大型資料，或須使用 SQL 的原生變更偵測功能進行累加式索引編制，請使用資料表。

若您須合併多個資料表的資料，請使用檢視。大型檢視不適用於 SQL 索引子。因應措施是建立新資料表，並僅用於擷取至您的 Azure AI 搜尋服務索引。您可以使用 SQL 整合式變更追蹤來追蹤新的和變更的數據列，這比高水標記更容易實作。
讀取權限。 Azure AI 搜尋服務支援 SQL Server 驗證，並會在連接字串中提供使用者名稱和密碼。或者，您可以設定受控識別並使用 Azure 角色。

若要完成本文中的範例，您需要 Azure 入口網站或 REST 用戶端。如果您使用的是 Azure 入口網站，請確定已在 Azure SQL 防火牆中啟用所有公用網路的存取權，且用戶端可透過輸入規則加以存取。針對在本機執行的 REST 用戶端，設定 SQL Server 防火牆以允許來自裝置 IP 位址的輸入存取。建立 Azure SQL 索引器的其他方法包括 Azure SDK。

嘗試使用範例數據

使用這些指示在 Azure SQL 資料庫中建立和載入數據表，以進行測試。

從 GitHub 下載hotels-azure-sql.sql，以在 Azure SQL 資料庫上建立數據表，其中包含範例旅館數據集的子集。
登入 Azure 入口網站並建立 Azure SQL 資料庫和資料庫伺服器。請考慮同時設定 SQL Server 驗證和Microsoft Entra ID 驗證。如果您沒有在 Azure 上設定角色的許可權，您可以使用 SQL 驗證作為因應措施。
將伺服器防火牆設定為來自本機裝置的所有輸入要求。
在您的 Azure SQL 資料庫上，選取 [查詢編輯器][預覽]， 然後選取 [ 新增查詢]。

貼上，然後執行建立 hotels 數據表的 T-SQL 腳本。

CREATE TABLE tbl_hotels
 (
     Id TINYINT PRIMARY KEY,
     Modified DateTime NULL DEFAULT '0000-00-00 00:00:00',
     IsDeleted TINYINT,
     HotelName VARCHAR(40),
     Category VARCHAR(20),
     City VARCHAR(30),
     State VARCHAR(4),
     Description VARCHAR(500)
 );

貼入，然後執行插入記錄的 T-SQL 腳稿。

 -- Insert rows
 INSERT INTO tbl_hotels (Id, Modified, IsDeleted, HotelName, Category, City, State, Description) VALUES (1, CURRENT_TIMESTAMP, 0,  'Stay-Kay City Hotel', 'Boutique', 'New York', 'NY', 'This classic hotel is fully-refurbished and ideally located on the main commercial artery of the city in the heart of New York. A few minutes away is Times Square and the historic centre of the city, as well as other places of interest that make New York one of Americas most attractive and cosmopolitan cities.');
 INSERT INTO tbl_hotels (Id, Modified, IsDeleted, HotelName, Category, City, State, Description) VALUES (10, CURRENT_TIMESTAMP, 0, 'Countryside Hotel', 'Extended-Stay', 'Durham', 'NC', 'Save up to 50% off traditional hotels. Free WiFi, great location near downtown, full kitchen, washer & dryer, 24\/7 support, bowling alley, fitness center and more.');
 INSERT INTO tbl_hotels (Id, Modified, IsDeleted, HotelName, Category, City, State, Description) VALUES (11, CURRENT_TIMESTAMP, 0, 'Royal Cottage Resort', 'Extended-Stay', 'Bothell', 'WA', 'Your home away from home. Brand new fully equipped premium rooms, fast WiFi, full kitchen, washer & dryer, fitness center. Inner courtyard includes water features and outdoor seating. All units include fireplaces and small outdoor balconies. Pets accepted.');
 INSERT INTO tbl_hotels (Id, Modified, IsDeleted, HotelName, Category, City, State, Description) VALUES (12, CURRENT_TIMESTAMP, 0, 'Winter Panorama Resort', 'Resort and Spa', 'Wilsonville', 'OR', 'Plenty of great skiing, outdoor ice skating, sleigh rides, tubing and snow biking. Yoga, group exercise classes and outdoor hockey are available year-round, plus numerous options for shopping as well as great spa services. Newly-renovated with large rooms, free 24-hr airport shuttle & a new restaurant. Rooms\/suites offer mini-fridges & 49-inch HDTVs.');
 INSERT INTO tbl_hotels (Id, Modified, IsDeleted, HotelName, Category, City, State, Description) VALUES (13, CURRENT_TIMESTAMP, 0, 'Luxury Lion Resort', 'Luxury', 'St. Louis', 'MO', 'Unmatched Luxury. Visit our downtown hotel to indulge in luxury accommodations. Moments from the stadium and transportation hubs, we feature the best in convenience and comfort.');
 INSERT INTO tbl_hotels (Id, Modified, IsDeleted, HotelName, Category, City, State, Description) VALUES (14, CURRENT_TIMESTAMP, 0, 'Twin Vortex Hotel', 'Luxury', 'Dallas', 'TX', 'New experience in the making. Be the first to experience the luxury of the Twin Vortex. Reserve one of our newly-renovated guest rooms today.');
 INSERT INTO tbl_hotels (Id, Modified, IsDeleted, HotelName, Category, City, State, Description) VALUES (15, CURRENT_TIMESTAMP, 0, 'By the Market Hotel', 'Budget', 'New York', 'NY', 'Book now and Save up to 30%. Central location. Walking distance from the Empire State Building & Times Square, in the Chelsea neighborhood. Brand new rooms. Impeccable service.');
 INSERT INTO tbl_hotels (Id, Modified, IsDeleted, HotelName, Category, City, State, Description) VALUES (16, CURRENT_TIMESTAMP, 0, 'Double Sanctuary Resort', 'Resort and Spa', 'Seattle', 'WA', '5 Star Luxury Hotel - Biggest Rooms in the city. #1 Hotel in the area listed by Traveler magazine. Free WiFi, Flexible check in\/out, Fitness Center & espresso in room.');
 INSERT INTO tbl_hotels (Id, Modified, IsDeleted, HotelName, Category, City, State, Description) VALUES (17, CURRENT_TIMESTAMP, 0, 'City Skyline Antiquity Hotel', 'Boutique', 'New York', 'NY', 'In vogue since 1888, the Antiquity Hotel takes you back to bygone era. From the crystal chandeliers that adorn the Green Room, to the arched ceilings of the Grand Hall, the elegance of old New York beckons. Elevate Your Experience. Upgrade to a premiere city skyline view for less, where old world charm combines with dramatic views of the city, local cathedral and midtown.');
 INSERT INTO tbl_hotels (Id, Modified, IsDeleted, HotelName, Category, City, State, Description) VALUES (18, CURRENT_TIMESTAMP, 0, 'Ocean Water Resort & Spa', 'Luxury', 'Tampa', 'FL', 'New Luxury Hotel for the vacation of a lifetime. Bay views from every room, location near the pier, rooftop pool, waterfront dining & more.');
 INSERT INTO tbl_hotels (Id, Modified, IsDeleted, HotelName, Category, City, State, Description) VALUES (19, CURRENT_TIMESTAMP, 0, 'Economy Universe Motel', 'Budget', 'Redmond', 'WA', 'Local, family-run hotel in bustling downtown Redmond. We are a pet-friendly establishment, near expansive Marymoor park, haven to pet owners, joggers, and sports enthusiasts. Close to the highway and just a short drive away from major cities.');
 INSERT INTO tbl_hotels (Id, Modified, IsDeleted, HotelName, Category, City, State, Description) VALUES (20, CURRENT_TIMESTAMP, 0, 'Delete Me Hotel', 'Unknown', 'Nowhere', 'XX', 'Test-case row for change detection and delete detection . For change detection, modify any value, and then re-run the indexer. For soft-delete, change IsDelete from zero to a one, and then re-run the indexer.');

執行查詢以確認上傳。
```
SELECT Description FROM tbl_hotels;
```

您應該會看到類似下列螢幕快照的結果。

[描述] 欄位提供最詳細的內容。您應該將此欄位設為全文搜索和選擇性向量化的目標。

現在您已有資料庫數據表，您可以使用 Azure 入口網站、REST 用戶端或 Azure SDK 來編制數據索引。

提示

您可以在 Azure-Samples/SQL-AI-samples 上找到另一個提供範例內容和程式代碼的資源。

使用 Azure 入口網站

您可以使用 [ 匯入數據 精靈] 或 [匯入及向量化數據 精靈]，從 SQL 資料庫數據表或檢視表自動編制索引。這兩個精靈的數據源組態很類似。

啟動精靈。
在 [連線到您的數據] 上，選取或確認數據源類型為 Azure SQL 資料庫 或 SQL Database。

數據源名稱是指 Azure AI 搜尋服務中的數據源連接物件。如果您使用向量精靈，則會使用精靈工作流程結尾指定的自定義前置詞自動產生數據源名稱。
指定伺服器名稱、資料庫名稱和數據表或檢視名稱。

Azure 入口網站會驗證連線。如果資料庫因為閑置而暫停，請流覽至資料庫伺服器頁面，並確定資料庫狀態為在線。您可以在任何數據表上執行查詢，以啟動資料庫。
指定驗證方法、在伺服器設定期間定義的 SQL Server 登入，或指定受控識別。

如果您將 Azure AI 搜尋設定為使用受控識別，並在授與 SQL Server 參與者或 SQL DB 參與者許可權給身分識別的資料庫伺服器上建立角色指派，您的索引器可以使用Microsoft Entra ID 和角色連線到 Azure SQL。
針對 [ 匯入和向量化數據 精靈]，您可以指定變更和刪除追蹤的選項。
- 刪除追蹤是以使用自定義元數據的虛刪除為基礎。
- 變更追蹤是以 SQL Server 整合式變更追蹤或高水印變更追蹤為基礎。
繼續進行其餘步驟以完成精靈：
- 快速入門：匯入數據精靈
- 快速入門：匯入和向量化數據精靈

使用 REST API

本節示範建立數據源、索引和索引器之 REST API 呼叫。

定義資料來源

資料來源定義指定要編製索引的資料、認證，以及用於識別資料變更的原則。資料來源定義為獨立的資源，因此可供多個索引子使用。

建立資料來源或建立或更新資料來源以設定其定義：

 POST https://myservice.search.windows.net/datasources?api-version=2024-07-01
 Content-Type: application/json
 api-key: admin-key

 {
     "name" : "myazuresqldatasource",
     "description" : "A database for testing Azure AI Search indexes.",
     "type" : "azuresql",
     "credentials" : { "connectionString" : "Server=tcp:<your server>.database.windows.net,1433;Database=<your database>;User ID=<your user name>;Password=<your password>;Trusted_Connection=False;Encrypt=True;Connection Timeout=30;" },
     "container" : { 
         "name" : "name of the table or view that you want to index",
         "query" : null (not supported in the Azure SQL indexer)
         },
     "dataChangeDetectionPolicy": null,
     "dataDeletionDetectionPolicy": null,
     "encryptionKey": null,
     "identity": null
 }

為遵循 Azure AI 搜尋服務命名慣例的資料來源提供唯一名稱。
將「type」設定為 "azuresql" (必要)。
將 "credentials" 設定為連接字串：
- 您可以從 Azure 入口網站完整存取連接字串。使用 ADO.NET connection string 選項。設定使用者名稱和密碼。
- 或者，您可以指定未包含資料庫秘密的受控識別連接字串，其格式如下：Initial Catalog|Database=<your database name>;ResourceId=/subscriptions/<your subscription ID>/resourceGroups/<your resource group name>/providers/Microsoft.Sql/servers/<your SQL Server name>/;Connection Timeout=connection timeout length;。
如需詳細資訊，請參閱使用受控識別連線至 Azure SQL Database 索引子。

將搜尋欄位新增至索引

在搜尋索引中，新增對應至 SQL 資料庫中欄位的欄位。使用對等資料類型，確定搜尋索引結構描述與來源結構描述相容。

建立或更新索引，以定義儲存資料的搜尋欄位：

POST https://[service name].search.windows.net/indexes?api-version=2024-07-01
Content-Type: application/json
api-key: [Search service admin key]
{
    "name": "mysearchindex",
    "fields": [{
        "name": "id",
        "type": "Edm.String",
        "key": true,
        "searchable": false
    }, 
    {
        "name": "description",
        "type": "Edm.String",
        "filterable": false,
        "searchable": true,
        "sortable": false,
        "facetable": false,
        "suggestions": true
    }
  ]
}

建立可唯一識別每個搜尋文件的文件索引鍵欄位 ("key": true)。這是搜尋索引中的唯一必要欄位。資料表的主索引鍵通常會對應至索引鍵欄位。文件索引鍵必須是唯一且非 null。來源資料中的值可以是數值，但在搜尋索引中，索引鍵一律為字串。
建立更多欄位以新增更多可搜尋內容。如需相關指引，請參閱建立索引。

對應資料類型

SQL 資料類型	Azure AI 搜尋服務欄位類型	備註
bit	Edm.Boolean、Edm.String
int、smallint、tinyint	Edm.Int32、Edm.Int64、Edm.String
bigint	Edm.Int64、Edm.String
real、float	Edm.Double、Edm.String
smallmoney、money 十進位數值	Edm.String	Azure AI 搜尋服務不支援將十進位類型轉換成 `Edm.Double`，因為這麼做會失去精確度
char、nchar、varchar、nvarchar	Edm.String Collection(Edm.String)	如果 SQL 字串代表下列 JSON 字串陣列，則該 SQL 字串可用於填入 Collection (`Edm.String`) 欄位：`["red", "white", "blue"]`
smalldatetime、datetime、datetime2、date、datetimeoffset	Edm.DateTimeOffset、Edm.String
uniqueidentifer	Edm.String
地理位置	Edm.GeographyPoint	僅支援使用 SRID 4326 (預設) 之 POINT 類型的 geography 執行個體。
rowversion	不適用	資料列版本的資料行無法儲存在搜尋索引中，但可用於追蹤變更
time、timespan、binary、varbinary、image、xml、geometry、CLR 類型	不適用	不支援

設定並執行 Azure SQL 索引子

建立索引與資料來源之後，您就可以開始建立索引子。索引子會設定指定輸入、參數和屬性，控制執行階段行為。

建立或更新索引子，指定其名稱並參考資料來源和目標索引：

POST https://[service name].search.windows.net/indexers?api-version=2024-07-01
Content-Type: application/json
api-key: [search service admin key]
{
    "name" : "[my-sqldb-indexer]",
    "dataSourceName" : "[my-sqldb-ds]",
    "targetIndexName" : "[my-search-index]",
    "disabled": null,
    "schedule": null,
    "parameters": {
        "batchSize": null,
        "maxFailedItems": 0,
        "maxFailedItemsPerBatch": 0,
        "base64EncodeKeys": false,
        "configuration": {
            "queryTimeout": "00:04:00",
            "convertHighWaterMarkToRowVersion": false,
            "disableOrderByHighWaterMarkColumn": false
        }
    },
    "fieldMappings": [],
    "encryptionKey": null
}

在 [參數] 底下，設定區段具有 Azure SQL 的特定參數：
- SQL 查詢執行的預設查詢逾時為 5 分鐘，您可以將其覆寫。
- "convertHighWaterMarkToRowVersion" 會針對上限標準變更偵測原則最佳化。變更偵測原則會在資料來源中設定。若您使用原生變更偵測原則，則此參數沒有任何作用。
- "disableOrderByHighWaterMarkColumn" 導致上限標準原則所使用的 SQL 查詢省略 ORDER BY 子句。若您使用原生變更偵測原則，則此參數沒有任何作用。
如果欄位名稱或類型有差異，或如果您在搜尋索引中需要來源欄位的多個版本，請指定欄位對應。
如需其他屬性的詳細資訊，請參閱建立索引子。

索引子建立後會自動執行。您可以將「停用」設為 true 避免此情況。若要控制索引子執行，請視需要執行索引子或排程執行索引子。

檢查索引子狀態

若要監視索引器狀態和執行歷程記錄，請檢查 Azure 入口網站中的索引器執行歷程記錄，或傳送取得索引器狀態 REST API 要求

入口網站
REST

在搜尋服務頁面上，開啟 [搜尋管理>索引器]。
選取索引器以存取組態和執行歷程記錄。
選取特定的索引器作業，以檢視詳細數據、警告和錯誤。

GET https://myservice.search.windows.net/indexers/myindexer/status?api-version=2024-07-01
  Content-Type: application/json  
  api-key: [admin key]

回應包含狀態和已處理的項目數目。回應會類似於下列範例：

    {
        "status":"running",
        "lastResult": {
            "status":"success",
            "errorMessage":null,
            "startTime":"2022-02-21T00:23:24.957Z",
            "endTime":"2022-02-21T00:36:47.752Z",
            "errors":[],
            "itemsProcessed":1599501,
            "itemsFailed":0,
            "initialTrackingState":null,
            "finalTrackingState":null
        },
        "executionHistory":
        [
            {
                "status":"success",
                "errorMessage":null,
                "startTime":"2022-02-21T00:23:24.957Z",
                "endTime":"2022-02-21T00:36:47.752Z",
                "errors":[],
                "itemsProcessed":1599501,
                "itemsFailed":0,
                "initialTrackingState":null,
                "finalTrackingState":null
            },
            ... earlier history items
        ]
    }

執行歷程記錄包含最多 50 個最近完成的執行，以顛倒的時序排序，因此最後的執行最先出現。

為新增、變更和刪除的資料列編製索引

如果您的 SQL 資料庫支援變更追蹤，則搜尋索引子可以在後續索引子執行時，僅挑選全新和更新的內容。

若要啟用累加式索引編製，請在資料來源定義中設定 "dataChangeDetectionPolicy" 屬性。這個屬性會告知索引子您的資料表和檢視上使用了哪種變更追蹤機制。

Azure SQL 索引子有兩個變更偵測原則：

"SqlIntegratedChangeTrackingPolicy" (僅適用於資料表)
"HighWaterMarkChangeDetectionPolicy" (適用於資料表和檢視)

SQL 整合變更追蹤原則

建議您使用 "SqlIntegratedChangeTrackingPolicy"，因其具備效率和識別已刪除資料列的能力。

資料庫需求：

SQL Server 2012 SP3 和更新版本 (若您在 Azure VM 上使用 SQL Server)
Azure SQL Database 或 SQL 受控執行個體
僅限資料表 (沒有檢視表)
在資料庫上，為資料表啟用變更追蹤
資料表上沒有複合主索引鍵 (主索引鍵包含不只一個資料行)
資料表上沒有叢集索引。因應措施是，必須卸除任何叢集索引並重新建立為非叢集索引，不過，相較於具有叢集索引，來源中的效能可能會受到影響

變更偵測原則會新增至資料來源定義。若要使用此原則，請以下列方式建立或更新您的資料來源：

POST https://myservice.search.windows.net/datasources?api-version=2024-07-01
Content-Type: application/json
api-key: admin-key
    {
        "name" : "myazuresqldatasource",
        "type" : "azuresql",
        "credentials" : { "connectionString" : "connection string" },
        "container" : { "name" : "table name" },
        "dataChangeDetectionPolicy" : {
            "@odata.type" : "#Microsoft.Azure.Search.SqlIntegratedChangeTrackingPolicy"
        }
    }

使用 SQL 整合式變更追蹤原則時，請勿指定個別資料刪除偵測原則。 SQL 整合式變更追蹤原則具有可用於識別已刪除資料列的內建支援。不過，若要自動偵測刪除的資料列，搜尋索引中的文件索引鍵必須與 SQL 資料表中的主索引鍵相同。

注意

使用 TRUNCATE TABLE 來移除 SQL 資料表中的大量資料列時，必須重設索引子，才能重設變更追蹤狀態，以挑選資料列刪除。

上限標準變更偵測原則

這個變更偵測原則依賴資料表或檢視中的「上限標準」資料行，此資料行可擷取上次更新資料列的版本或時間。若您使用檢視，就必須使用上限標準原則。

上限標準資料行必須符合下列需求：

所有插入都有指定資料行的值。
所有項目更新變更資料行的值。
每次插入或更新都會增加此資料行的值。
具有下列 WHERE 和 ORDER BY 子句的查詢可以有效率地執行︰WHERE [High Water Mark Column] > [Current High Water Mark Value] ORDER BY [High Water Mark Column]

注意

我們強烈建議針對上限標記資料行使用 rowversion 資料類型。如果使用任何其他資料類型，便無法保證變更追蹤會擷取與索引子查詢同時執行的交易中發生的所有變更。在具備唯讀複本的設定中使用 rowversion 時，您必須指向主要複本上的索引子。只有主要複本可用於資料同步處理案例。

變更偵測原則會新增至資料來源定義。若要使用此原則，請以下列方式建立或更新您的資料來源：

POST https://myservice.search.windows.net/datasources?api-version=2024-07-01
Content-Type: application/json
api-key: admin-key
    {
        "name" : "myazuresqldatasource",
        "type" : "azuresql",
        "credentials" : { "connectionString" : "connection string" },
        "container" : { "name" : "table or view name" },
        "dataChangeDetectionPolicy" : {
            "@odata.type" : "#Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy",
            "highWaterMarkColumnName" : "[a rowversion or last_updated column name]"
        }
    }

注意

如果來源資料表沒有上限標準資料行的索引，SQL 索引子所使用的查詢可能會逾時。特別是，當資料表包含許多資料列時，ORDER BY [High Water Mark Column] 子句需要索引才能有效率地執行。

convertHighWaterMarkToRowVersion

若您針對上限標準資料行使用 rowversion 資料類型，請考慮在索引子設定中設定 convertHighWaterMarkToRowVersion 屬性。若您將此屬性設定為 true，則會導致下列行為：

針對索引子 SQL 查詢中的上限標準資料行，使用 rowversion 資料類型。使用正確的資料類型可改善索引子查詢效能。
在索引子查詢執行之前，從 rowversion 值減一。具有一對多聯結的檢視可能包含具有重複 rowversion 值的資料列。減一可確保索引子查詢不會遺漏這些資料列。

若要啟用此屬性，請使用下列設定建立或更新索引子：

    {
      ... other indexer definition properties
     "parameters" : {
            "configuration" : { "convertHighWaterMarkToRowVersion" : true } }
    }

queryTimeout

如果您遇到逾時錯誤，請將 queryTimeout 索引子組態設定設為高於預設逾時 (5 分鐘) 的值。例如，若要將逾時設定為 10 分鐘，請使用下列組態建立或更新索引子︰

    {
      ... other indexer definition properties
     "parameters" : {
            "configuration" : { "queryTimeout" : "00:10:00" } }
    }

disableOrderByHighWaterMarkColumn

您也可以停用 ORDER BY [High Water Mark Column] 子句。不過不建議您這麼做，因為如果索引子的執行因發生錯誤而中斷，索引子必須在稍後執行時重新處理所有資料列，即便索引子在中斷發生當時已幾乎處理好所有資料列也是如此。若要停用 ORDER BY 子句，請在索引子定義中使用 disableOrderByHighWaterMarkColumn 設定︰

    {
     ... other indexer definition properties
     "parameters" : {
            "configuration" : { "disableOrderByHighWaterMarkColumn" : true } }
    }

虛刪除資料行刪除偵測原則

當從來源資料表中刪除資料列時，您應該也想刪除在搜尋索引內的那些資料列。若您使用 SQL 整合變更追蹤原則，就能幫您處理這件工作。但是，上限標準變更追蹤原則無法幫助您刪除資料列。怎麼辦？

若資料列已實際從資料表內移除，Azure AI 搜尋服務便無法推斷出不復存在的記錄。不過，您可以使用「虛刪除」技術，以邏輯方式刪除資料列，而不需從資料表加以移除。在資料表或檢視中新增資料行，並使用該資料行將資料列標記為已刪除。

當您使用虛刪除技術時，可以在建立或升級資料來源時，按照下列方式指定虛刪除原則：

    {
        …,
        "dataDeletionDetectionPolicy" : {
           "@odata.type" : "#Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy",
           "softDeleteColumnName" : "[a column name]",
           "softDeleteMarkerValue" : "[the value that indicates that a row is deleted]"
        }
    }

softDeleteMarkerValue 必須是資料來源 JSON 表示中的字串。使用實際值的字串表示。例如，如果您有整數資料行，且其中的已刪除資料列標記為值 1，請使用 "1"。如果您有 BIT 資料行，且其中的已刪除資料列標記為布林值 true，則請使用字串常值 "True" 或 "true"，大小寫並不重要。

若要從 Azure 入口網站設定虛刪除原則，請勿在虛刪除標記值前後加上引號。欄位內容已瞭解為字串，並會自動轉譯為 JSON 字串。在先前的範例中，只要在 Azure 入口網站的欄位中輸入 1或 True true 。

常見問題集

問：我可以對 Always Encrypted 資料行編製索引嗎？

否，Azure AI 搜尋服務索引子目前不支援 Always Encrypted 資料行。

問：我可以在 Azure 中搭配在 IaaS VM 上執行的 SQL 資料庫，使用 Azure SQL 索引子嗎？

是。不過，您需要允許搜尋服務連接到資料庫。如需詳細資訊，請參閱在 Azure VM 上設定從 Azure AI 搜尋服務索引子到 SQL Server 的連線。

問：我可以搭配在內部部署執行的 SQL 資料庫，使用 Azure SQL 索引子嗎？

無法直接進行。我們不建議或不支援直接連線，因為這樣做需要您開啟資料庫以接收網際網路流量。客戶需要使用像是 Azure Data Factory 的橋接器技術，才能成功執行此案例。如需詳細資訊，請參閱使用 Azure Data Factory 將資料推送到 Azure AI 搜尋服務索引。

問：是否可以在容錯移轉叢集中使用次要複本作為資料來源？

要看情況而定。針對完整編製索引的資料表或檢視，您可以使用次要複本。

針對累加式編製索引，Azure AI 搜尋服務支援兩個變更偵測原則：SQL 整合變更追蹤與上限標準。

在唯讀複本中，SQL 資料庫不支援整合變更追蹤。因此，您必須使用上限標準原則。

我們的標準建議是，針對上限標記資料行使用 rowversion 資料類型。不過，使用 rowversion 會依賴唯讀複本上不支援的 MIN_ACTIVE_ROWVERSION 函式。因此，如果您使用 rowversion，就必須將索引子指向主要複本。

如果您嘗試在唯讀複本上使用 rowversion，您會收到下列錯誤：

「次要 (唯讀) 可用性複本不支援使用 rowversion 資料行來追蹤變更。更新數據源，並指定主要可用性複本的連線。目前資料庫的 'Updateability' 屬性為 'READ_ONLY'」。

問：我是否可以針對上限標準變更追蹤使用替代的非 rowversion 資料行？

我們不建議使用。僅允許使用 rowversion 進行可靠的資料同步處理。不過，根據您的應用程式邏輯而定，如果符合下列情況，則它可能是安全的：

您可以確保在索引子執行時，已編製索引的資料表上沒有任何未完成的交易 (例如，所有資料表更新均會在排程中以批次形式執行，以及已設定 Azure AI 搜尋服務索引子排程以防止與資料表更新排程重疊)。
您會定期進行完整的重新編製索引，以挑選出任何遺失的資料列。

共用方式為

從 Azure SQL 資料庫編製數據的索引

必要條件

嘗試使用範例數據

使用 Azure 入口網站

使用 REST API

定義資料來源

將搜尋欄位新增至索引

對應資料類型

設定並執行 Azure SQL 索引子

檢查索引子狀態

為新增、變更和刪除的資料列編製索引

SQL 整合變更追蹤原則

上限標準變更偵測原則

convertHighWaterMarkToRowVersion

queryTimeout

disableOrderByHighWaterMarkColumn

虛刪除資料行刪除偵測原則

常見問題集

意見反應

其他資源

共用方式為

從 Azure SQL 資料庫 編製數據的索引

必要條件

嘗試使用範例數據

使用 Azure 入口網站

使用 REST API

定義資料來源

將搜尋欄位新增至索引

對應資料類型

設定並執行 Azure SQL 索引子

檢查索引子狀態

為新增、變更和刪除的資料列編製索引

SQL 整合變更追蹤原則

上限標準變更偵測原則

convertHighWaterMarkToRowVersion

queryTimeout

disableOrderByHighWaterMarkColumn

虛刪除資料行刪除偵測原則

常見問題集

意見反應

其他資源

從 Azure SQL 資料庫編製數據的索引