關於Azure Search的二三事 talking about Azure Search , this slider include two language, if want see English version , you can jump at 18 page

1. 3分鐘Azure Search自我
介紹
Jaja

2. 開始前…
 使用前要先有服務的URL跟API金錀
 服務 URL命名完後不可修改
 要指定API版本
 一組服務金錀有分為Manger(2組)與Query(50組)
 建立Index時column屬性的設定會影響後續查詢

3. 免費試用限制
 儲存空間上限50MB
 文件數量10000個
 最多只能建3個索引
 不保證你的效能(笑)

4. 大家都有的限制-Request
 Maximum of 16 MB per request
 Maximum 8 KB URL length
 Maximum 1000 documents per batch of index uploads, merges, or deletes.
 Maximum 25 characters of text in Suggest API request, minimum 3 characters
 Maximum 32 fields in $orderby clause
 Maximum search term size is 32766 bytes (32 KB minute 2 bytes) of UTF-8 encoded
text

5. 大家都有的限制-Response
 Maximum 1000 documents returned per page of search results
 Maximum 10 suggestions returned per Suggest API request

6. 兩個預覽的板本

7. 兩種操作
There are two types of actions that can be executed against the Azure Search Service:
• Index Management: This includes administrative tasks that are executed against a search
service or search index.
• Document Actions: These actions query and manage the corpus for a given index

8. 索引 操作
 CREATE -> POST /indexes?api-version=2014-07-31-Preview
 UPDATE -> PUT /indexes/[index name]?api-version=2014-07-31-Preview
 DELETE -> DELETE /indexes/[index name]?api-version=2014-07-31-Preview
 GET -> GET /indexes/[index name]?api-version=2014-07-31-Preview
 LIST -> GET /indexes?api-version=2014-07-31-Preview

9. 文件 操作
 DML -> POST /indexes/[index name]/docs/index?api-version=2014-07-31-Preview
 GET -> GET /indexes/[index name]/docs?[query parameters]
 Lookup -> GET /indexes/[index name]/docs/[key]?[query parameters]
 DML 操作是用JSON欄位 @search.action做定義
 "@search.action": "upload (default) | merge | mergeOrUpload | delete"

10. 服務命名規則
 長度需介於2-15之間
 只能用小寫英文數字與破折號( - )
 不能用連續的破折號 ( -----helloworld-----)
 第二個字元不能用破折號

11. 不要用破折號!!!

12. 索引命名規則
 長度需介於2-128之間
 只能用小寫英文數字與破折號( - )
 不能用連續的破折號 ( -----helloworld-----)
 不能有斜線( / )或是點( . )

13. 欄位命名規則
 除了英文數字，還可以用底線 ( _ )
 但是要英文開頭
 不能有點( . )、分號( : ) 跟小老鼠 ( @ )
 不能用azureSearch當開頭

14. 文件命名規則
 不準用底線開頭 ( _ )
 不能有斜線( / )與點( . )
 建議用 | 來分割你的複合主鍵

15. Tips
 增加複本可以提升每秒查詢數量與高可用性(最少3個)
 複本會比較常使用
 資料分割只會應用在特定的場合

16. C# 使用Azure Search
 請愛用 HttpClient
 Header 一定要有 api-key
 搭配HttpRequestMessage送出資料
 傳輸的資料內容一定是JSON格式
 詳細的範例 : https://azuresearchadventureworksdemo.codeplex.com/
 記得用NuGet console更新一下MVC
 Update-package -reinstall Microsoft.AspNet.Mvc

17. End

18. English Version

19. Begin…
 Need service URL and API Key before start
 Cannot rename service name
 Requests must include the api-version
 One service include two API Key – Manage(2) and Query (50) .
 Index column attribute will affect your query

20. Free trial Limite
 Storage limit 50MB
 Documents limit 10000
 Only 3 index
 They don't ensure service usable

21. Request Limit
 Maximum of 16 MB per request
 Maximum 8 KB URL length
 Maximum 1000 documents per batch of index uploads, merges, or deletes.
 Maximum 25 characters of text in Suggest API request, minimum 3 characters
 Maximum 32 fields in $orderby clause
 Maximum search term size is 32766 bytes (32 KB minute 2 bytes) of UTF-8 encoded
text

22. Response Limit
 Maximum 1000 documents returned per page of search results
 Maximum 10 suggestions returned per Suggest API request

23. Two Preview version Now

24. Two Operating
There are two types of actions that can be executed against the Azure Search Service:
• Index Management: This includes administrative tasks that are executed against a search service or search in
• Document Actions: These actions query and manage the corpus for a given index

25. Index
 CREATE -> POST /indexes?api-version=2014-07-31-Preview
 UPDATE -> PUT /indexes/[index name]?api-version=2014-07-31-Preview
 DELETE -> DELETE /indexes/[index name]?api-version=2014-07-31-Preview
 GET -> GET /indexes/[index name]?api-version=2014-07-31-Preview
 LIST -> GET /indexes?api-version=2014-07-31-Preview

26. Document
 DML -> POST /indexes/[index name]/docs/index?api-version=2014-07-31-Preview
 GET -> GET /indexes/[index name]/docs?[query parameters]
 Lookup -> GET /indexes/[index name]/docs/[key]?[query parameters]
 DML operating is use JSON column @search.action to declare action
 "@search.action": "upload (default) | merge | mergeOrUpload | delete"

27. Service name conventions
 Must be between 2 and 15 characters
 Must start with a letter or number, followed by zero or more letters, numbers or
dashes ('-')
 Must be lowercase
 Consecutive dashes are not allowed
 Second character cannot be a dash

28. Don’t use dashes !!!

29. Index name conventions
 Must be between 2 and 128 characters total
 Must start with a letter or number, followed by zero or more letters, numbers
or dashes ('-')
 Must be lowercase
 Consecutive dashes are not allowed

30. Field name conventions
 Must be between 1 and 128 characters
 Can contain letters, numbers, and underscore ('_')
 Must start with a letter
 Cannot start with "azureSearch"

31. Document key naming conventions
 Can contain letters, numbers, underscore ('_'), dashes ('-'), or equal sign ('=')
 Cannot start with an underscore ('_')
 If you use compound keys and need a separator, we recommend using '-', '_',
or '='.
 If the keys in your source data contain characters other than the above, we
recommend encoding them using a URL-safe variant of Base64. For example,
in .NET you can use the HttpServerUtility.UrlTokenEncode method for this
purpose.
 Cannot contain backslash (''), slash ('/'), or dot ('.')
 If you use compound keys and need a separator, we recommend using |.

32. Tips
 Increasing queries per second (QPS) or achieving high availability is done by
adding replicas
 high availability need last three replicas
 Replicas almost used in application

33. C# Azure Search
 Using HttpClient
 Header need have api-key
 Use HttpRequestMessage send content
 Data only use JSON
 More example: https://azuresearchadventureworksdemo.codeplex.com/
 You may need use NuGet console to updating MVC reference
 Update-package -reinstall Microsoft.AspNet.Mvc