Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Semantische Suche nach AWS Glue Data Catalog
<a name="catalog-semantic-search"></a>

**Anmerkung**  
Der Geschäftskontext und die semantische Suche befinden sich in der Vorversion AWS Glue und können sich ändern.

Die semantische Suche ermöglicht es Ihnen, Datenbestände nicht nur anhand ihrer Bedeutung, sondern auch anhand der exakten Zuordnung von Schlüsselwörtern zu ermitteln. Die Ergebnisse werden nach der semantischen Ähnlichkeit mit Ihrer Anfrage geordnet. Sie können die Ergebnisse eingrenzen, indem Sie Filter nach Asset-Typ, Metadatenfeldern und Glossarbegriffen verwenden.

## Mithilfe der API SearchAssets
<a name="catalog-semantic-search-api"></a>

Die `SearchAssets` API akzeptiert `SearchText``FilterClause`, oder beides. Wenn keiner von beiden angegeben wird, werden alle Vermögenswerte zurückgegeben. Optionale Parameter:`Sort`,`MaxResults`,`NextToken`.

### Textsuche
<a name="catalog-semantic-search-text"></a>

```
aws glue search-assets \
    --search-text "customer purchases"
```

Beispielausgabe:

```
{
    "Items": [
        {"Id": "c9vq7sh2fk4t2h", "AssetName": "Customer Sales Transactions", "AssetTypeId": "Table"}
    ]
}
```

Ergebnisse einschränken mit`--max-results`:

```
aws glue search-assets \
    --search-text "quarterly revenue" \
    --max-results 5
```

### Suchergebnisse filtern
<a name="catalog-semantic-search-filters"></a>

Wird verwendet`FilterClause`, um die Ergebnisse einzugrenzen. Unterstützte Filtertypen:
+ **AttributeFilter**— Operatoren: `equals``greaterThan`,`greaterThanOrEquals`,`lessThan`,`lessThanOrEquals`,`notExists`.
+ **AndAllFilters**— Alle Filter müssen übereinstimmen (logisches UND).
+ **OrAnyFilters**— Mindestens einer muss übereinstimmen (logisches ODER).

**Um nach einem einzelnen Attribut zu filtern**  
Nur nach Tabellen-Assets filtern:

```
aws glue search-assets \
    --search-text "revenue" \
    --filter-clause '{
        "AttributeFilter": {
            "Attribute": "type",
            "Operator": "equals",
            "Value": {"StringValue": "Table"}
        }
    }'
```

**Um Filter mit UND-Logik zu kombinieren**  
Suchen Sie nach Tabellenbeständen, die nach einem Zeitstempel aktualisiert wurden:

```
aws glue search-assets \
    --search-text "customer data" \
    --filter-clause '{
        "AndAllFilters": [
            {"AttributeFilter": {"Attribute": "type", "Operator": "equals", "Value": {"StringValue": "Table"}}},
            {"AttributeFilter": {"Attribute": "updatedAt", "Operator": "greaterThan", "Value": {"LongValue": 1718400000}}}
        ]
    }'
```

**Um Filter mit ODER-Logik zu kombinieren**  
Suchen Sie nach Tabellen oder Skill-Assets:

```
aws glue search-assets \
    --search-text "customer data" \
    --filter-clause '{
        "OrAnyFilters": [
            {"AttributeFilter": {"Attribute": "type", "Operator": "equals", "Value": {"StringValue": "Table"}}},
            {"AttributeFilter": {"Attribute": "type", "Operator": "equals", "Value": {"StringValue": "Skill"}}}
        ]
    }'
```

**Um nach einem Begriff im Glossar zu filtern**  
Nach Assets filtern, die mit einem bestimmten Glossarbegriff versehen sind (nach Begriffs-ID):

```
aws glue search-assets \
    --search-text "financial data" \
    --filter-clause '{
        "AttributeFilter": {
            "Attribute": "glossaryTerms",
            "Operator": "equals",
            "Value": {"StringValue": "{{glossary-term-id}}"}
        }
    }'
```

**Um verschachtelte UND- und OR-Filter zu verwenden**  
Suchen Sie nach Tabellen- oder Skill-Assets mit einem bestimmten Glossarbegriff:

```
aws glue search-assets \
    --search-text "customer" \
    --filter-clause '{
        "AndAllFilters": [
            {"OrAnyFilters": [
                {"AttributeFilter": {"Attribute": "type", "Operator": "equals", "Value": {"StringValue": "Table"}}},
                {"AttributeFilter": {"Attribute": "type", "Operator": "equals", "Value": {"StringValue": "Skill"}}}
            ]},
            {"AttributeFilter": {"Attribute": "glossaryTerms", "Operator": "equals", "Value": {"StringValue": "{{glossary-term-id}}"}}}
        ]
    }'
```

### Suchergebnisse sortieren
<a name="catalog-semantic-search-sort"></a>

Standardmäßig werden die Ergebnisse nach semantischer Relevanz sortiert. Um nach Attributen zu sortieren:

```
aws glue search-assets \
    --search-text "customer purchases" \
    --sort '{"Attribute": "assetName", "Order": "ASCENDING"}'
```

```
aws glue search-assets \
    --search-text "customer purchases" \
    --sort '{"Attribute": "updatedAt", "Order": "DESCENDING"}'
```

**Anmerkung**  
Wenn Sie ein Sortierattribut angeben, werden die Ergebnisse nach diesem Attribut und nicht nach semantischer Relevanz sortiert.

### Paginieren der Suchergebnisse
<a name="catalog-semantic-search-pagination"></a>

Wenn die Anzahl der Ergebnisse überschritten wird`MaxResults`, enthält die Antwort eine`NextToken`. Verwenden Sie es, um zusätzliche Seiten abzurufen.

```
aws glue search-assets \
    --search-text "customer data" \
    --max-results 10 \
    --next-token "eyJsYXN0RXZhbHVhdGVkS2V5Ijp7ImlkIjp7InMiOiJhMWIyYzNkNCJ9fX0="
```

Fahren Sie fort, bis die Antwort kein A mehr enthält`NextToken`.

## Reine Filterabfragen ausführen
<a name="catalog-semantic-search-filter-only"></a>

Verwenden Sie nur `FilterClause` ohne`SearchText`, um Assets ohne semantisches Ranking aufzulisten.

```
aws glue search-assets \
    --filter-clause '{"AttributeFilter": {"Attribute": "type", "Operator": "equals", "Value": {"StringValue": "Table"}}}' \
    --max-results 20
```

**Anmerkung**  
Wenn Sie sowohl als `SearchText` auch weglassen`FilterClause`, gibt die API alle Assets zurück.

## Beispiele
<a name="catalog-semantic-search-examples"></a>

**Um Skill-Assets für eine Domain zu ermitteln**  
Finden Sie Fähigkeiten, die sich auf Verkaufsdaten beziehen:

```
aws glue search-assets \
    --search-text "sales domain usage rules" \
    --filter-clause '{"AttributeFilter": {"Attribute": "type", "Operator": "equals", "Value": {"StringValue": "Skill"}}}'
```

**Anmerkung**  
Diese Abfrage gibt nur benutzerdefinierte Skill-Assets zurück. Verwaltete Fähigkeiten werden von der `SearchAssets` API nicht zurückgegeben.

**Um Textsuche und Sortierung zu kombinieren**  
Verschaffen Sie sich einen umfassenden Überblick über passende Assets:

```
aws glue search-assets \
    --search-text "customer" \
    --sort '{"Attribute": "updatedAt", "Order": "DESCENDING"}' \
    --max-results 10
```