Cloud SQL-Datendefinitionssprache (Data Definition Language, DDL)

Auf dieser Seite wird die Syntax für Cloud SQL-Erweiterungen der DDL-Anweisungen (Data Definition Language) für MySQL definiert.

`VECTOR`-Anweisungen

In diesem Abschnitt finden Sie Informationen zu VECTOR-Anweisungen.

CREATE VECTOR INDEX

Erstellt einen Vektorindex.

CREATE VECTOR INDEX index_name
[opt_index_type]
ON table_name (column_name)
[index_options]

where opt_index_type is:
 | USING SCANN

where index_option is :
 USING SCANN
 | [QUANTIZER=SQ8]
 | [NUM_LEAVES=int_value]
 | DISTANCE_MEASURE=L2_SQUARED|DOT_PRODUCT|COSINE

Parameter

  • USING SCANN: erforderlich. Der Indextyp, der beim Erstellen des Vektorindex verwendet werden soll. Mit diesem Algorithmus wird ein ScaNN Index erstellt. SCANN ist der einzige unterstützte Wert. Dieser Parameter kann nicht geändert werden.
  • QUANTIZER: optional. Dieser Parameter ordnet einen hochdimensionalen Vektor einer komprimierten Darstellung zu. SQ8 ist der einzige unterstützte Wert. Dieser Parameter kann nicht geändert werden.
  • NUM_LEAVES: optional. Gibt an, wie viele Partitionen (Blätter) erstellt werden sollen. Ändern Sie diese Einstellung nur von der Standardeinstellung, wenn Sie sich gut mit der ANN-Suche und Ihrem Dataset auskennen. Die angegebene Zahl darf nicht größer als die Anzahl der Einbettungen in der Basistabelle sein.
  • DISTANCE_MEASURE: erforderlich. Eine mathematische Formel, mit der die Ähnlichkeit zweier Vektoren berechnet wird. Sie müssen für diesen Parameter dasselbe Distanzmaß festlegen wie für die Distanz in den approx_distance-Suchoptionen. Die unterstützten seitlichen Werte sind:
    • L2_SQUARED
    • COSINE
    • DOT_PRODUCT

Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie einen Vektorindex für die Tabelle table_name erstellen:

CREATE
  VECTOR INDEX index1
ON table_name(vector_column_name)
USING SCANN QUANTIZER = SQ8 DISTANCE_MEASURE = l2_squared;

ALTER TABLE

Fügt einer vorhandenen Tabelle einen Vektorindex hinzu. Für Vektorsuchen ist SCANN als Indexoption erforderlich und der Quantisierungstyp muss SQ8 sein.

ALTER TABLE table_name
  ADD VECTOR INDEX index_name(key_part)[index_option];

WHERE key_part is:{ _col_name_[(_length_)] | (_expr_) }
WHERE
  index_option
  is:USING
    SCANN
    | [QUANTIZER = SQ8]
    | [NUM_LEAVES = int_value]
    | DISTANCE_MEASURE
  = L2_SQUARED | DOT_PRODUCT | COSINE

Parameter

  • USING SCANN: erforderlich. Der Indextyp, der beim Erstellen des Vektorindex verwendet werden soll. Mit diesem Algorithmus wird ein ScaNN Index erstellt. SCANN ist der einzige unterstützte Wert. Dieser Parameter kann nicht geändert werden.
  • QUANTIZER: optional. Dieser Parameter ordnet einen hochdimensionalen Vektor einer komprimierten Darstellung zu. SQ8 ist der einzige unterstützte Wert. Dieser Parameter kann nicht geändert werden.
  • NUM_LEAVES: optional. Gibt an, wie viele Partitionen (Blätter) erstellt werden sollen. Ändern Sie diese Einstellung nur von der Standardeinstellung, wenn Sie sich gut mit der ANN-Suche und Ihrem Dataset auskennen. Die angegebene Zahl darf nicht größer als die Anzahl der Einbettungen in der Basistabelle sein.
  • DISTANCE_MEASURE: erforderlich. Eine mathematische Formel, mit der die Ähnlichkeit zweier Vektoren berechnet wird. Sie müssen für diesen Parameter dasselbe Distanzmaß festlegen wie für die Distanz in den approx_distance-Suchoptionen. Die unterstützten seitlichen Werte sind:
    • L2_SQUARED
    • COSINE
    • DOT_PRODUCT

Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie der Tabelle t1 einen Vektorindex hinzufügen:

ALTER TABLE t1 ADD VECTOR INDEX index1(j)
USING SCANN QUANTIZER = SQ8 DISTANCE_MEASURE = l2_squared;

Nächste Schritte