typesense go下載 - typesense go源碼下載

類型感知-go

Typesense API 的 Go 用戶端：https://github.com/typesense/typesense

安裝

 go get github.com/typesense/typesense-go/v2/typesense

用法

將包匯入到您的程式碼：

 import "github.com/typesense/typesense-go/v2/typesense"

建立新客戶端：

 client := typesense . NewClient (
	    typesense . WithServer ( "http://localhost:8108" ),
	    typesense . WithAPIKey ( "<API_KEY>" ))

具有進階配置選項的新客戶端（請參閱 godoc）：

 client := typesense . NewClient (
		typesense . WithServer ( "http://localhost:8108" ),
		typesense . WithAPIKey ( "<API_KEY>" ),
		typesense . WithConnectionTimeout ( 5 * time . Second ),
		typesense . WithCircuitBreakerMaxRequests ( 50 ),
		typesense . WithCircuitBreakerInterval ( 2 * time . Minute ),
		typesense . WithCircuitBreakerTimeout ( 1 * time . Minute ),
	)

具有多節點配置選項的新客戶端：

 client := typesense . NewClient (
		typesense . WithNearestNode ( "https://xxx.a1.typesense.net:443" ),
		typesense . WithNodes ([] string {
			"https://xxx-1.a1.typesense.net:443" ,
			"https://xxx-2.a1.typesense.net:443" ,
			"https://xxx-3.a1.typesense.net:443" ,
		}),
		typesense . WithAPIKey ( "<API_KEY>" ),
		typesense . WithNumRetries ( 5 ),
		typesense . WithRetryInterval ( 1 * time . Second ),
		typesense . WithHealthcheckInterval ( 2 * time . Minute ),
	)

您還可以在整合測試中找到一些範例。

建立一個集合

	schema := & api. CollectionSchema {
		Name : "companies" ,
		Fields : []api. Field {
			{
				Name : "company_name" ,
				Type : "string" ,
			},
			{
				Name : "num_employees" ,
				Type : "int32" ,
			},
			{
				Name :  "country" ,
				Type :  "string" ,
				Facet : true ,
			},
		},
		DefaultSortingField : pointer . String ( "num_employees" ),
	}

	client . Collections (). Create ( context . Background (), schema )

鍵入文件操作

在v2.0.0 + 中，用戶端可讓您定義文件結構以用於某些文件操作的類型。

為此，您必須使用typesense.GenericCollection ：

 type companyDocument struct {
    ID           string `json:"id"`
    CompanyName  string `json:"company_name"`
    NumEmployees int    `json:"num_employees"`
    Country      string `json:"country"`
}

// doc is a typed document
doc , err := typesense . GenericCollection [ * companyDocument ]( typesenseClient , collectionName ). Document ( "123" ). Retrieve ( context . Background ())

索引文檔

	document := struct {
		ID           string `json:"id"`
		CompanyName  string `json:"company_name"`
		NumEmployees int    `json:"num_employees"`
		Country      string `json:"country"`
	}{
		ID :           "123" ,
		CompanyName :  "Stark Industries" ,
		NumEmployees : 5215 ,
		Country :      "USA" ,
	}

	client . Collection ( "companies" ). Documents (). Create ( context . Background (), document )

更新插入文檔

	newDocument := struct {
		ID           string `json:"id"`
		CompanyName  string `json:"company_name"`
		NumEmployees int    `json:"num_employees"`
		Country      string `json:"country"`
	}{
		ID :           "123" ,
		CompanyName :  "Stark Industries" ,
		NumEmployees : 5215 ,
		Country :      "USA" ,
	}

	client . Collection ( "companies" ). Documents (). Upsert ( context . Background (), newDocument )

搜尋集合

	searchParameters := & api. SearchCollectionParams {
		Q :        pointer . String ( "stark" ),
		QueryBy :  pointer . String ( "company_name" ),
		FilterBy : pointer . String ( "num_employees:>100" ),
		SortBy :   & ([] string { "num_employees:desc" }),
	}

	client . Collection ( "companies" ). Documents (). Search ( context . Background (), searchParameters )

對於支援多個QueryBy參數，可以在每個字段後面添加,

	searchParameters := & api. SearchCollectionParams {
		Q :        pointer . String ( "stark" ),
		QueryBy :  pointer . String ( "company_name, country" ),
		FilterBy : pointer . String ( "num_employees:>100" ),
		SortBy :   & ([] string { "num_employees:desc" }),
	}

	client . Collection ( "companies" ). Documents (). Search ( context . Background (), searchParameters )

檢索文件

 client . Collection ( "companies" ). Document ( "123" ). Retrieve ( context . Background ())

更新文件

	document := struct {
		CompanyName  string `json:"company_name"`
		NumEmployees int    `json:"num_employees"`
	}{
		CompanyName :  "Stark Industries" ,
		NumEmployees : 5500 ,
	}

	client . Collection ( "companies" ). Document ( "123" ). Update ( context . Background (), document )

刪除單一文檔

 client . Collection ( "companies" ). Document ( "123" ). Delete ( context . Background ())

刪除一堆文檔

 filter := & api. DeleteDocumentsParams { FilterBy : "num_employees:>100" , BatchSize : 100 }
client . Collection ( "companies" ). Documents (). Delete ( context . Background (), filter )

檢索集合

 client . Collection ( "companies" ). Retrieve ( context . Background ())

從集合匯出文檔

 client . Collection ( "companies" ). Documents (). Export ( context . Background ())

將文件導入到集合中

若要匯入的文件可以是文件物件數組，也可以格式化為換行符號分隔的 JSON 字串（請參閱 JSONL）。

導入一組文件：

	documents := [] interface {}{
		struct {
			ID           string `json:"id"`
			CompanyName  string `json:"companyName"`
			NumEmployees int    `json:"numEmployees"`
			Country      string `json:"country"`
		}{
			ID :           "123" ,
			CompanyName :  "Stark Industries" ,
			NumEmployees : 5215 ,
			Country :      "USA" ,
		},
	}
	params := & api. ImportDocumentsParams {
		Action :    pointer . String ( "create" ),
		BatchSize : pointer . Int ( 40 ),
	}

	client . Collection ( "companies" ). Documents (). Import ( context . Background (), documents , params )

導入 JSONL 檔案：

	params := & api. ImportDocumentsParams {
		Action :    pointer . String ( "create" ),
		BatchSize : pointer . Int ( 40 ),
	}
	importBody , err := os . Open ( "documents.jsonl" )
	// defer close, error handling ...

	client . Collection ( "companies" ). Documents (). ImportJsonl ( context . Background (), importBody , params )

列出所有集合

 client . Collections (). Retrieve ( context . Background ())

刪除一個集合

 client . Collection ( "companies" ). Delete ( context . Background ())

建立 API 金鑰

	keySchema := & api. ApiKeySchema {
		Description : "Search-only key." ,
		Actions :     [] string { "documents:search" },
		Collections : [] string { "companies" },
		ExpiresAt :   time . Now (). AddDate ( 0 , 6 , 0 ). Unix (),
	}

	client . Keys (). Create ( context . Background (), keySchema )

檢索 API 金鑰

 client . Key ( 1 ). Retrieve ( context . Background ())

列出所有鍵

 client . Keys (). Retrieve ( context . Background ())

刪除 API 金鑰

 client . Key ( 1 ). Delete ( context . Background ())

建立或更新覆蓋

	override := & api. SearchOverrideSchema {
		Rule : api. SearchOverrideRule {
			Query : "apple" ,
			Match : "exact" ,
		},
		Includes : []api. SearchOverrideInclude {
			{
				Id :       "422" ,
				Position : 1 ,
			},
			{
				Id :       "54" ,
				Position : 2 ,
			},
		},
		Excludes : []api. SearchOverrideExclude {
			{
				Id : "287" ,
			},
		},
	}

	client . Collection ( "companies" ). Overrides (). Upsert ( context . Background (), "customize-apple" , override )

列出所有覆蓋

 client . Collection ( "companies" ). Overrides (). Retrieve ( context . Background ())

刪除覆蓋

 client . Collection ( "companies" ). Override ( "customize-apple" ). Delete ( context . Background ())

建立或更新別名

	body := & api. CollectionAliasSchema { CollectionName : "companies_june11" }
	client . Aliases (). Upsert ( "companies" , body )

檢索別名

 client . Alias ( "companies" ). Retrieve ( context . Background ())

列出所有別名

 client . Aliases (). Retrieve ( context . Background ())

刪除別名

 client . Alias ( "companies" ). Delete ( context . Background ())

建立或更新多路同義詞

	synonym := & api. SearchSynonymSchema {
		Synonyms : [] string { "blazer" , "coat" , "jacket" },
	}
	client . Collection ( "products" ). Synonyms (). Upsert ( context . Background (), "coat-synonyms" , synonym )

建立或更新單向同義詞

	synonym := & api. SearchSynonymSchema {
		Root :     "blazer" ,
		Synonyms : [] string { "blazer" , "coat" , "jacket" },
	}
	client . Collection ( "products" ). Synonyms (). Upsert ( context . Background (), "coat-synonyms" , synonym )

檢索同義詞

 client . Collection ( "products" ). Synonym ( "coat-synonyms" ). Retrieve ( context . Background ())

列出所有同義詞

 client . Collection ( "products" ). Synonyms (). Retrieve ( context . Background ())

刪除同義詞

 client . Collection ( "products" ). Synonym ( "coat-synonyms" ). Delete ( context . Background ())

建立或更新停用詞集

	stopwords := & api. StopwordsSetUpsertSchema {
		Locale :    pointer . String ( "en" ),
		Stopwords : [] string { "Germany" , "France" , "Italy" , "United States" },
	}
	client . Stopwords (). Upsert ( context . Background (), "stopword_set1" , stopwords )

檢索停用詞集

 client . Stopword ( "stopword_set1" ). Retrieve ( context . Background ())

列出所有停用詞集

 client . Stopwords (). Retrieve ( context . Background ())

刪除停用詞集

 client . Stopword ( "stopword_set1" ). Delete ( context . Background ())

建立或更新預設

 preset := & api. PresetUpsertSchema {}
preset . Value . FromMultiSearchSearchesParameter (api. MultiSearchSearchesParameter {
		Searches : []api. MultiSearchCollectionParameters {
			{
				Collection : "books" ,
			},
		},
	})
// or: preset.Value.FromSearchParameters(api.SearchParameters{Q: "Books"})

client . Presets (). Upsert ( context . Background (), "listing-view-preset" , preset )

檢索預設

 client . Preset ( "listing-view-preset" ). Retrieve ( context . Background ())

列出所有預設

 client . Presets (). Retrieve ( context . Background ())

刪除預設

 client . Preset ( "listing-view-preset" ). Delete ( context . Background ())

建立快照（用於備份）

 client . Operations (). Snapshot ( context . Background (), "/tmp/typesense-data-snapshot" )

重新選舉領導人

 client . Operations (). Vote ( context . Background ())

集群指標

 client . Metrics (). Retrieve ( context . Background ())

API統計

 client . Stats (). Retrieve ( context . Background ())

貢獻

歡迎在 GitHub 上提交錯誤報告和拉取請求：https://github.com/typesense/typesense-go。

開發工作流程設定

安裝依賴項，

go mod download

更新生成的文件，

go generate ./...

執照

typesense-go在 Apache 2 許可證下分發。

展開