1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

{
  "class": "string",                        // The name of the class in string format
  "description": "string",                  // A description for your reference
  "vectorIndexType": "hnsw",                // Defaults to hnsw, can be omitted in schema definition since this is the only available type for now
  "vectorIndexConfig": {
    ...                                     // Vector index type specific settings, including distance metric
  },
  "vectorizer": "text2vec-contextionary",   // Vectorizer to use for data objects added to this class
  "moduleConfig": {
    "text2vec-contextionary": {
      "vectorizeClassName": true            // Include the class name in vector calculation (default true)
    }
  },
  "properties": [                           // An array of the properties you are adding, same as a Property Object
    {
      "name": "string",                     // The name of the property
      "description": "string",              // A description for your reference
      "dataType": [                         // The data type of the object as described above. When creating cross-references, a property can have multiple data types, hence the array syntax.
        "string"
      ],
      "moduleConfig": {                     // Module-specific settings
        "text2vec-contextionary": {
          "skip": true,                     // If true, the whole property will NOT be included in vectorization. Default is false, meaning that the object will be NOT be skipped.
          "vectorizePropertyName": true,    // Whether the name of the property is used in the calculation for the vector position of data objects. Default false.
        }
      },
      "indexInverted": true                 // Optional, default is true. By default each property is fully indexed both for full-text, as well as vector search. You can ignore properties in searches by explicitly setting index to false.
    }
  ],
  "invertedIndexConfig": { 
    ... 
  },
  "shardingConfig": {
    ...                                     // Optional, controls behavior of class in a multi-node setting, see section below
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

version: '3.4'
services:
  weaviate:
    image: semitechnologies/weaviate:1.18.3
    ports:
      - "8080:8080"
    environment:
      QUERY_DEFAULTS_LIMIT: 20
      AUTHENTICATION_ANONYMOUS_ACCESS_ENABLED: 'true'
      PERSISTENCE_DATA_PATH: "./data"
      DEFAULT_VECTORIZER_MODULE: text2vec-transformers
      ENABLE_MODULES: text2vec-transformers
      TRANSFORMERS_INFERENCE_API: http://t2v-transformers:8080
      CLUSTER_HOSTNAME: 'node1'
  t2v-transformers:
    image: semitechnologies/transformers-inference:sentence-transformers-multi-qa-MiniLM-L6-cos-v1
    environment:
      ENABLE_CUDA: 0 # set to 1 to enable
      # NVIDIA_VISIBLE_DEVICES: all # enable if running with CUDA

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

client.Schema().ClassCreator().WithClass(&models.Class{
  Class:       className,
  Description: "all books I have",
  Vectorizer:  "text2vec-transformers",
  ModuleConfig: map[string]interface{}{
    "text2vec-transformers": map[string]interface{}{},
  },
  Properties: []*models.Property{
    {
      Name:     "title",
      DataType: []string{"text"},
    },
  },
})

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

objects := []*models.Object{
  {
    Class: className,
    Properties: map[string]interface{}{
      "title": "Hello World Blue",
      "type":  "program",
    },
  },
  {
    Class: className,
    Properties: map[string]interface{}{
      "title": "Hello World Red",
      "type":  "program",
    },
  }, {
    Class: className,
    Properties: map[string]interface{}{
      "title": "Hello World Yellow",
      "type":  "science",
    },
  },
}

client.Batch().ObjectsBatcher().
  WithObjects(objects...).
  WithConsistencyLevel(replication.ConsistencyLevel.ALL).
  Do(context.Background())

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

// 文字搜尋
nearText := client.GraphQL().NearTextArgBuilder().
  // 搜尋的關鍵字
  WithConcepts(concepts).
  // 讓向量往某個方向靠近
  WithMoveTo(&graphql.MoveParameters{
    Force: 0.5,
    Concepts: []string{
      "Yellow",
    },
  })

// 篩選機制
where := filters.Where().
  WithPath([]string{"type"}).
  WithOperator(filters.Equal).
  WithValueText("program")

// 選擇欄位回傳
fields := []graphql.Field{
  {Name: "title"},
  // 額外的欄位，算是 metadata
  {Name: "_additional", Fields: []graphql.Field{
    {Name: "id"},
    {Name: "distance"},
  }},
}

// GraphQL Request
result, err := client.GraphQL().Get().
  WithClassName(className).
  WithNearText(nearText).
  WithWhere(where).
  WithFields(fields...).
  Do(context.Background())

if result.Errors != nil {
  for _, err := range result.Errors {
    fmt.Println(err.Message)
  }
  return
}

r := result.Data["Get"].(map[string]interface{})[className].([]interface{})

jsonbody, err := json.Marshal(r)
if err != nil {
  // do error check
  fmt.Println(err)
  return
}

books := []Book{}
if err := json.Unmarshal(jsonbody, &books); err != nil {
  // do error check
  fmt.Println(err)
  return
}

for _, book := range books {
  fmt.Println(book)
}

1
2
3
4
5
6
7
8

nearText := client.GraphQL().NearTextArgBuilder().
  WithConcepts(concepts).
  WithMoveTo(&graphql.MoveParameters{
      Force: 0.5,
      Concepts: []string{
          "Yellow",
      },
  })

1
2
3
4

where := filters.Where().
  WithPath([]string{"type"}).
  WithOperator(filters.Equal).
  WithValueText("program")