Object Storage Service:Vector search

Java

Solo Java SDK 3.18.2 y versiones posteriores admiten la búsqueda vectorial. Para obtener más información, consulte Vector search (Java SDK V1).

Python

Para obtener más información, consulte Vector search.

import argparse import alibabacloud_oss_v2 as oss # Create a command-line argument parser and add a description. parser = argparse.ArgumentParser(description="open meta query sample") # Add the required command-line argument --region to specify the region where the bucket is located. parser.add_argument('--region', help='The region in which the bucket is located.', required=True) # Add the required command-line argument --bucket to specify the name of the bucket to operate on. parser.add_argument('--bucket', help='The name of the bucket.', required=True) # Add the optional command-line argument --endpoint to specify the domain name used to access OSS. parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS') def main(): # Parse command-line arguments. args = parser.parse_args() # Load authentication information from environment variables. credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider() # Use the default configurations provided by the SDK. cfg = oss.config.load_default() # Set the authentication information provider. cfg.credentials_provider = credentials_provider # Set the region based on command-line arguments. cfg.region = args.region # If an endpoint is provided, update the endpoint in the configuration. if args.endpoint is not None: cfg.endpoint = args.endpoint # Create an OSS client. client = oss.Client(cfg) # Build an OpenMetaQueryRequest to enable the AISearch feature for the bucket. result = client.open_meta_query(oss.OpenMetaQueryRequest( bucket=args.bucket, mode='semantic',# Set to "semantic" to select AISearch. )) # Print the status code and request ID of the request. print(f'status code: {result.status_code},' f' request id: {result.request_id},' ) # Call the main function when running as the main program. if __name__ == "__main__": main()

Go

Para obtener más información, consulte Vector search (Go SDK V2).

package main import ( "context" "flag" "log" "github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss" "github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials" ) var ( region string bucketName string ) func init() { // Set a command-line flag to specify the region. flag.StringVar(&region, "region", "", "The region in which the bucket is located.") // Set a command-line flag to specify the bucket name. flag.StringVar(&bucketName, "bucket", "", "The name of the bucket.") } func main() { flag.Parse() // Check if the bucket name is provided. if len(bucketName) == 0 { flag.PrintDefaults() log.Fatalf("invalid parameters, bucket name required") } // Check if the region is provided. if len(region) == 0 { flag.PrintDefaults() log.Fatalf("invalid parameters, region required") } // Create a client configuration and use credentials from environment variables. cfg := oss.LoadDefaultConfig(). WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()). WithRegion(region) client := oss.NewClient(cfg) // Create an OSS client. // Create a request to enable AISearch for the specified bucket. request := &oss.OpenMetaQueryRequest{ Bucket: oss.Ptr(bucketName), Mode: oss.Ptr("semantic"), // Set mode to "semantic" to enable semantic search capabilities. } result, err := client.OpenMetaQuery(context.TODO(), request) if err != nil { log.Fatalf("failed to open meta query %v", err) } log.Printf("open meta query result:%#v\n", result) }

PHP

Para obtener más información, consulte Vector search (PHP SDK V2).

<?php // Include the autoload file to load dependencies. require_once __DIR__ . '/../vendor/autoload.php'; use AlibabaCloud\Oss\V2 as Oss; // Define and describe command-line parameters. $optsdesc = [ "region" => ['help' => 'The region in which the bucket is located.', 'required' => True], // (Required) The region in which the bucket resides. "endpoint" => ['help' => 'The domain names that other services can use to access OSS.', 'required' => False], // (Optional) The endpoint that other services can use to access OSS. "bucket" => ['help' => 'The name of the bucket', 'required' => True], // (Required) The name of the bucket. ]; // Convert the descriptions to a list of long options required by getopt. // Add a colon (:) to the end of each parameter to indicate that a value is required. $longopts = \array_map(function ($key) { return "$key:"; }, array_keys($optsdesc)); // Parse the command-line parameters. $options = getopt("", $longopts); // Check whether the required parameters are configured. foreach ($optsdesc as $key => $value) { if ($value['required'] === True && empty($options[$key])) { $help = $value['help']; // Obtain help information for the parameters. echo "Error: the following arguments are required: --$key, $help" . PHP_EOL; exit(1); // Exit the program if a required parameter is missing. } } // Assign the values parsed from the command-line parameters to the corresponding variables. $region = $options["region"]; // The region in which the bucket resides. $bucket = $options["bucket"]; // The name of the bucket. // Load access credentials from environment variables. // Use EnvironmentVariableCredentialsProvider to retrieve the AccessKey ID and AccessKey secret from environment variables. $credentialsProvider = new Oss\Credentials\EnvironmentVariableCredentialsProvider(); // Use the default configuration of the SDK. $cfg = Oss\Config::loadDefault(); $cfg->setCredentialsProvider($credentialsProvider); // Specify the credential provider. $cfg->setRegion($region); // Specify the region in which the bucket resides. if (isset($options["endpoint"])) { $cfg->setEndpoint($options["endpoint"]); // Specify the endpoint if one is provided. } // Create an OSSClient instance. $client = new Oss\Client($cfg); // Enable the AISearch feature. $request = new Oss\Models\OpenMetaQueryRequest($bucket,'semantic'); $result = $client->openMetaQuery($request); printf( 'status code:' . $result->statusCode . PHP_EOL . 'request id:' . $result->requestId );

Java

Solo Java SDK 3.18.2 y versiones posteriores admiten la búsqueda vectorial. Para obtener más información, consulte Vector search (Java SDK V1).

Python

Para obtener más información, consulte Vector search.

import argparse import alibabacloud_oss_v2 as oss # Create a command-line argument parser to process command-line input. parser = argparse.ArgumentParser(description="do meta query semantic sample") # Add the necessary command-line arguments. parser.add_argument('--region', help='The region in which the bucket is located.', required=True) # The region where the bucket is located. parser.add_argument('--bucket', help='The name of the bucket.', required=True) # The name of the bucket. parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS') # The OSS domain name, which is optional. def main(): # Parse command-line arguments. args = parser.parse_args() # Load access credentials from environment variables. # Before running, you need to set the environment variables: OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET. credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider() # Load the default SDK configurations. cfg = oss.config.load_default() # Set the credential provider. cfg.credentials_provider = credentials_provider # Set the region. cfg.region = args.region # If an endpoint is provided, update the endpoint in the configuration. if args.endpoint is not None: cfg.endpoint = args.endpoint # Create an OSS client instance. client = oss.Client(cfg) # Initiate a metadata query request in AISearch mode. result = client.do_meta_query(oss.DoMetaQueryRequest( bucket=args.bucket, mode='semantic', meta_query=oss.MetaQuery( max_results=1000, query='An aerial view of a snow-covered forest', order='desc', media_types=oss.MetaQueryMediaTypes( media_type=['image'] ), simple_query='{"Operation":"gt", "Field": "Size", "Value": "30"}', ), )) # Print the retrieval results. print(vars(result)) if __name__ == "__main__": main()

Go

Para obtener más información, consulte Vector search (Go SDK V2).

package main import ( "context" "flag" "log" "github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss" "github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials" ) var ( region string bucketName string ) func init() { // Set a command-line flag to specify the region. flag.StringVar(&region, "region", "", "The region in which the bucket is located.") // Set a command-line flag to specify the bucket name. flag.StringVar(&bucketName, "bucket", "", "The name of the bucket.") } func main() { flag.Parse() // Check if the bucket name is provided. if len(bucketName) == 0 { flag.PrintDefaults() log.Fatalf("invalid parameters, bucket name required") } // Check if the region is provided. if len(region) == 0 { flag.PrintDefaults() log.Fatalf("invalid parameters, region required") } // Create a client configuration and use credentials from environment variables and the specified region. cfg := oss.LoadDefaultConfig(). WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()). WithRegion(region) client := oss.NewClient(cfg) // Create an OSS client. // Perform an AISearch operation. request := &oss.DoMetaQueryRequest{ Bucket: oss.Ptr(bucketName), Mode: oss.Ptr("semantic"), MetaQuery: &oss.MetaQuery{ MaxResults: oss.Ptr(int64(99)), Query: oss.Ptr({"Operation":"match","Field":"Filename","Value":"snow"}), // The Query parameter must be in JSON format (for example, {"Operation":"match","Field":"Filename","Value":"snow"}). MediaTypes: &oss.MetaQueryMediaTypes{ MediaTypes: []string{"image"}, // Specify the media types to search. In this example, "image". }, SimpleQuery: oss.Ptr({"Operation":"gt", "Field": "Size", "Value": "30"}), }, } result, err := client.DoMetaQuery(context.TODO(), request) if err != nil { log.Fatalf("failed to do meta query %v", err) } log.Printf("do meta query result:%#v\n", result) }

PHP

Para obtener más información, consulte Vector search (PHP SDK V2).

<?php // Import the autoloader file to ensure that dependency libraries are correctly loaded. require_once __DIR__ . '/../vendor/autoload.php'; use AlibabaCloud\Oss\V2 as Oss; // Define the description of command line arguments. $optsdesc = [ "region" => ['help' => 'The region in which the bucket is located.', 'required' => True], // The region where the bucket is located. This parameter is required. "endpoint" => ['help' => 'The domain names that other services can use to access OSS.', 'required' => False], // The endpoint that other services can use to access OSS. This parameter is optional. "bucket" => ['help' => 'The name of the bucket', 'required' => True], // The name of the bucket. This parameter is required. ]; // Convert the argument description to the long option format required by getopt. // A colon (:) after each argument indicates that the argument requires a value. $longopts = \array_map(function ($key) { return "$key:"; }, array_keys($optsdesc)); // Parse the command line arguments. $options = getopt("", $longopts); // Check whether required arguments are specified. foreach ($optsdesc as $key => $value) { if ($value['required'] === True && empty($options[$key])) { $help = $value['help']; // Obtain the help information of the argument. echo "Error: the following arguments are required: --$key, $help" . PHP_EOL; exit(1); // If a required argument is not specified, exit the program. } } // Extract values from the parsed arguments. $region = $options["region"]; // The region where the bucket is located. $bucket = $options["bucket"]; // The name of the bucket. // Load the credential information from environment variables. // Use EnvironmentVariableCredentialsProvider to read the Access Key ID and Access Key Secret from environment variables. $credentialsProvider = new Oss\Credentials\EnvironmentVariableCredentialsProvider(); // Use the default configurations of the SDK. $cfg = Oss\Config::loadDefault(); $cfg->setCredentialsProvider($credentialsProvider); // Set the credential provider. $cfg->setRegion($region); // Set the region where the bucket is located. if (isset($options["endpoint"])) { $cfg->setEndpoint($options["endpoint"]); // If an endpoint is provided, set the endpoint. } // Create an OSS client instance. $client = new Oss\Client($cfg); // Perform an AISearch query for objects that meet the specified conditions. $request = new Oss\Models\DoMetaQueryRequest($bucket, new Oss\Models\MetaQuery( maxResults: 99, query: "Overlook the snow-covered forest", mediaTypes: new Oss\Models\MetaQueryMediaTypes('image'), simpleQuery: '{"Operation":"gt", "Field": "Size", "Value": "30"}', ), 'semantic'); $result = $client->doMetaQuery($request); printf( 'status code:' . $result->statusCode . PHP_EOL . 'request id:' . $result->requestId . PHP_EOL . 'result:' . var_export($result, true) );

Java

Solo Java SDK 3.18.2 y versiones posteriores admiten la búsqueda vectorial. Para obtener más información, consulte Vector search (Java SDK V1).

Python

Para obtener más información, consulte Vector search.

import argparse import alibabacloud_oss_v2 as oss # Create a command-line argument parser to process command-line arguments. parser = argparse.ArgumentParser(description="close meta query sample") parser.add_argument('--region', help='The region in which the bucket is located.', required=True) parser.add_argument('--bucket', help='The name of the bucket.', required=True) parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS') def main(): # Parse command-line arguments. args = parser.parse_args() # Load credential information from environment variables. credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider() # Use the default configurations of the SDK. cfg = oss.config.load_default() # Set the credential provider to the credentials obtained from environment variables. cfg.credentials_provider = credentials_provider # Set the region information in the configuration. cfg.region = args.region # If an endpoint is provided, set the endpoint in the configuration. if args.endpoint is not None: cfg.endpoint = args.endpoint # Create an OSS client. client = oss.Client(cfg) # Call the close_meta_query method to disable the retrieval feature for the bucket. result = client.close_meta_query(oss.CloseMetaQueryRequest( bucket=args.bucket, )) # Print the status code and request ID of the response. print(f'status code: {result.status_code}, request id: {result.request_id}') # Execute the main function when this script is run directly. if __name__ == "__main__": main()

Go

Para obtener más información, consulte Vector search (Go SDK V2).

package main import ( "context" "flag" "log" "github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss" "github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials" ) var ( region string bucketName string ) func init() { // Set a command-line flag to specify the region. flag.StringVar(&region, "region", "", "The region in which the bucket is located.") // Set a command-line flag to specify the bucket name. flag.StringVar(&bucketName, "bucket", "", "The name of the bucket.") } func main() { flag.Parse() // Check if the bucket name is provided. if len(bucketName) == 0 { flag.PrintDefaults() log.Fatalf("invalid parameters, bucket name required") } // Check if the region is provided. if len(region) == 0 { flag.PrintDefaults() log.Fatalf("invalid parameters, region required") } // Create a client configuration and use credentials from environment variables and the specified region. cfg := oss.LoadDefaultConfig(). WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()). WithRegion(region) client := oss.NewClient(cfg) // Create an OSS client. // Create a request to disable AISearch for the specified bucket. request := &oss.CloseMetaQueryRequest{ Bucket: oss.Ptr(bucketName), // Specify the target bucket. } result, err := client.CloseMetaQuery(context.TODO(), request) if err != nil { log.Fatalf("failed to close meta query %v", err) } log.Printf("close meta query result:%#v\n", result) }

PHP

Para obtener más información, consulte Vector search (PHP SDK V2).

<?php // Import the autoloader file to ensure that dependency libraries are correctly loaded. require_once __DIR__ . '/../vendor/autoload.php'; use AlibabaCloud\Oss\V2 as Oss; // Define the description of command line arguments. $optsdesc = [ "region" => ['help' => 'The region in which the bucket is located.', 'required' => True], // The region where the bucket is located. This parameter is required. "endpoint" => ['help' => 'The domain names that other services can use to access OSS.', 'required' => False], // The endpoint that other services can use to access OSS. This parameter is optional. "bucket" => ['help' => 'The name of the bucket', 'required' => True], // The name of the bucket. This parameter is required. ]; // Convert the argument description to the long option format required by getopt. // A colon (:) after each argument indicates that the argument requires a value. $longopts = \array_map(function ($key) { return "$key:"; }, array_keys($optsdesc)); // Parse the command line arguments. $options = getopt("", $longopts); // Check whether required arguments are specified. foreach ($optsdesc as $key => $value) { if ($value['required'] === True && empty($options[$key])) { $help = $value['help']; // Obtain the help information of the argument. echo "Error: the following arguments are required: --$key, $help" . PHP_EOL; exit(1); // If a required argument is not specified, exit the program. } } // Extract values from the parsed arguments. $region = $options["region"]; // The region where the bucket is located. $bucket = $options["bucket"]; // The name of the bucket. // Load the credential information from environment variables. // Use EnvironmentVariableCredentialsProvider to read the Access Key ID and Access Key Secret from environment variables. $credentialsProvider = new Oss\Credentials\EnvironmentVariableCredentialsProvider(); // Use the default configurations of the SDK. $cfg = Oss\Config::loadDefault(); $cfg->setCredentialsProvider($credentialsProvider); // Set the credential provider. $cfg->setRegion($region); // Set the region where the bucket is located. if (isset($options["endpoint"])) { $cfg->setEndpoint($options["endpoint"]); // If an endpoint is provided, set the endpoint. } // Create an OSS client instance. $client = new Oss\Client($cfg); // Create a CloseMetaQueryRequest object to disable the retrieval feature for the bucket. $request = new \AlibabaCloud\Oss\V2\Models\CloseMetaQueryRequest( bucket: $bucket ); // Execute the operation to disable the retrieval feature. $result = $client->closeMetaQuery($request); // Print the result of disabling the retrieval feature. printf( 'status code:' . $result->statusCode . PHP_EOL . // The HTTP status code. For example, 200 indicates that the request is successful. 'request id:' . $result->requestId . PHP_EOL // The request ID, which is used for debugging or request tracking. );