配置环境变量
配置环境变量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。
重要
阿里云账号AccessKey拥有所有API的访问权限,建议您使用RAM用户进行API访问或日常运维,具体操作,请参见创建RAM用户。
创建AccessKey ID和AccessKey Secret,请参考创建AccessKey。
如果您使用的是RAM用户的AccessKey,请确保主账号已授权AliyunServiceRoleForOpenSearch服务关联角色,请参考OpenSearch-行业算法版服务关联角色,相关文档参考访问鉴权规则。
请不要将AccessKey ID和AccessKey Secret保存到工程代码里,否则可能导致AccessKey泄露,威胁您账号下所有资源的安全。
Linux和macOS系统配置方法:
执行以下命令,其中,
<access_key_id>
需替换为您RAM用户的AccessKey ID,<access_key_secret>
替换为您RAM用户的AccessKey Secret。export ALIBABA_CLOUD_ACCESS_KEY_ID=<access_key_id> export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<access_key_secret>
Windows系统配置方法
新建环境变量文件,添加环境变量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET,并写入已准备好的AccessKey ID和AccessKey Secret。
重启Windows系统生效。
安装Package 依赖
Package 依赖地址:https://www.nuget.org/packages
dotnet add package AlibabaCloud.TeaUtil --version 0.1.5
dotnet add package AlibabaCloud.OpenSearchUtil --version 1.0.2
dotnet add package Aliyun.Credentials --version 1.2.1
dotnet add package Tea --version 0.4.0
示例代码
以下是C# SDK 的示例代码:
using System;
using System.Collections.Generic;
using AlibabaCloud.TeaUtil.Models;
using Tea;
namespace ConsoleApp2
{
internal class Program
{
public static Dictionary<string, object> behaviorBulk(Client opensearchClient, string appName,
string collectionName, List<object> docContent, Dictionary<string, string> header, RuntimeOptions runTime)
{
string pathName = "/v3/openapi/app-groups/" + appName + "/data-collections/" + collectionName +
"/data-collection-type/BEHAVIOR/actions/bulk";
try
{
return opensearchClient._request("POST", pathName, null, header, docContent, runTime);
}
catch (Exception e)
{
Console.WriteLine(e);
throw;
}
}
private static void Main(string[] args)
{
var runtime = new RuntimeOptions
{
ConnectTimeout = 5000,
ReadTimeout = 10000,
MaxAttempts = 0,
Autoretry = false,
IgnoreSSL = false,
MaxIdleConns = 50
};
var config = new Config
{
// 配置统一的请求入口, 此信息可从业务控制台获取.
Endpoint = "opensearch-cn-hangzhou.aliyuncs.com",
// 支持 protocol 配置 HTTPS/HTTP
Protocol = "HTTPS",
/* 用户识别信息
从环境变量读取配置的AccessKey ID和AccessKey Secret,
运行代码示例前必须先配置环境变量,参考文档上面“配置环境变量”步骤 */
AccessKeyId = System.Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
AccessKeySecret = System.Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
// 支持 type 配置 sts/access_key 鉴权. 其中 type 默认为 access_key 鉴权. 使用 sts 可配置 RAM-STS 鉴权.
// 备选参数为:sts 或者 access_key
Type = "access_key",
// 如果使用 RAM-STS 鉴权, 请配置 security_token, 可使用阿里云 AssumeRole 获取 相关 STS 鉴权结构.
SecurityToken = "",
};
// 创建 opensearch client 实例
var openSearch = new Client(config);
// 要搜索的appName.
var appName = "appName";
// 自定义HttpHeaders .
var header = new Dictionary<string, string>();
// --------------- 行为日志 ---------------
// item_id 信息为搜索结果返回的主键信息. 特定为主键 id.
string item_id = "358713";
// ops_request_misc 为搜索请求返回的 ops_request_misc 信息.
string ops_request_misc =
"%7B%22request%5Fid%22%3A%22161777635816780357273903%22%2C%22scm%22%3A%2220140713.130149759..%22%7D";
// bhv_type 为 行为事件的特征信息, 备选信息如下为类别:
// cart(加购物车)
// collect(收藏)
// like(点赞)
// comment(评论)
// buy(购买)
// click(点击/查看)
string bhv_type = "click";
// request_id 为搜索请求返回的 request_id 信息.
string request_id = "161777635816780357273903";
// 该数据到达服务端的时间,格式:时间戳,单位:秒
string reach_time = "1709708439";
// 用于唯一标识终端应用上的用户的ID。
// *一般为登录用户ID。
// *对于PC端,如果是未登录用户,也可以设置为cookieid
string user_id = "a7a0d37c824b659f36a5b9e3b819fcdd";
List<object> behaviorDocs = new List<object>();
Dictionary<string, object> behaviorDoc = new Dictionary<string, object>();
Dictionary<string, object> behaviorDocFields = new Dictionary<string, object>()
{
{"item_id", item_id},
{"sdk_type", "opensearch_sdk"},
{"sdk_version", "<sdk_version>"}, // 当前使用的 opensearch sdk 的版本号.
{"trace_id", "ALIBABA"}, // 用于区分调用了哪个服务商的服务
{"trace_info", ops_request_misc},
{"bhv_type", bhv_type},
{"item_type", "item"},
{"rn", request_id},
{"biz_id", "<biz_id>"}, // 手机或终端应用用于区分业务的一个数值ID,该字段可用来和OpenSearch上的应用或和AIRec上的实例做关联
{"reach_time", reach_time},
{"user_id", user_id}
};
behaviorDoc.Add("cmd", "ADD");
behaviorDoc.Add("fields", behaviorDocFields);
behaviorDocs.Add(behaviorDoc);
try
{
behaviorBulk(openSearch, appName, appName, behaviorDocs, header, runtime);
}
catch (Exception e)
{
Console.WriteLine(e);
throw;
}
}
}
}
说明
参考:推送采集数据