feat(samples): add list-entity-types samples (googleapis#313)

samples/list-entity-types-async-sample.js

@@ -0,0 +1,86 @@
+/*
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*
+ * Lists EntityTypes Asynchronously in a given Featurestore.
+ * See https://cloud.google.com/vertex-ai/docs/featurestore/setup before running
+ * the code snippet
+ */
+
+'use strict';
+
+async function main(
+  project,
+  featurestoreId,
+  location = 'us-central1',
+  apiEndpoint = 'us-central1-aiplatform.googleapis.com',
+  timeout = 300000
+) {
+  // [START aiplatform_list_entity_types_async_sample]
+  /**
+   * TODO(developer): Uncomment these variables before running the sample.\
+   * (Not necessary if passing values as arguments)
+   */
+
+  // const project = 'YOUR_PROJECT_ID';
+  // const featurestoreId = 'YOUR_FEATURESTORE_ID';
+  // const location = 'YOUR_PROJECT_LOCATION';
+  // const apiEndpoint = 'YOUR_API_ENDPOINT';
+  // const timeout = <TIMEOUT_IN_MILLI_SECONDS>;
+
+  // Imports the Google Cloud Featurestore Service Client library
+  const {FeaturestoreServiceClient} = require('@google-cloud/aiplatform').v1;
+
+  // Specifies the location of the api endpoint
+  const clientOptions = {
+    apiEndpoint: apiEndpoint,
+  };
+
+  // Instantiates a client
+  const featurestoreServiceClient = new FeaturestoreServiceClient(
+    clientOptions
+  );
+
+  async function listEntityTypesAsync() {
+    // Configure the parent resource
+    const parent = `projects/${project}/locations/${location}/featurestores/${featurestoreId}`;
+
+    const request = {
+      parent: parent,
+    };
+
+    // List EntityTypes Async request
+    const iterable = await featurestoreServiceClient.listEntityTypesAsync(
+      request,
+      {timeout: Number(timeout)}
+    );
+
+    console.log('List entity types async response');
+    console.log('Raw response:');
+    for await (const response of iterable) {
+      console.log(JSON.stringify(response, null, 2));
+    }
+  }
+  listEntityTypesAsync();
+  // [END aiplatform_list_entity_types_async_sample]
+}
+
+process.on('unhandledRejection', err => {
+  console.error(err.message);
+  process.exitCode = 1;
+});
+
+main(...process.argv.slice(2));

samples/list-entity-types-sample.js

@@ -0,0 +1,84 @@
+/*
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*
+ * Lists EntityTypes in a given Featurestore.
+ * See https://cloud.google.com/vertex-ai/docs/featurestore/setup before running
+ * the code snippet
+ */
+
+'use strict';
+
+async function main(
+  project,
+  featurestoreId,
+  location = 'us-central1',
+  apiEndpoint = 'us-central1-aiplatform.googleapis.com',
+  timeout = 300000
+) {
+  // [START aiplatform_list_entity_types_sample]
+  /**
+   * TODO(developer): Uncomment these variables before running the sample.\
+   * (Not necessary if passing values as arguments)
+   */
+
+  // const project = 'YOUR_PROJECT_ID';
+  // const featurestoreId = 'YOUR_FEATURESTORE_ID';
+  // const location = 'YOUR_PROJECT_LOCATION';
+  // const apiEndpoint = 'YOUR_API_ENDPOINT';
+  // const timeout = <TIMEOUT_IN_MILLI_SECONDS>;
+
+  // Imports the Google Cloud Featurestore Service Client library
+  const {FeaturestoreServiceClient} = require('@google-cloud/aiplatform').v1;
+
+  // Specifies the location of the api endpoint
+  const clientOptions = {
+    apiEndpoint: apiEndpoint,
+  };
+
+  // Instantiates a client
+  const featurestoreServiceClient = new FeaturestoreServiceClient(
+    clientOptions
+  );
+
+  async function listEntityTypes() {
+    // Configure the parent resource
+    const parent = `projects/${project}/locations/${location}/featurestores/${featurestoreId}`;
+
+    const request = {
+      parent: parent,
+    };
+
+    // List EntityTypes request
+    const [response] = await featurestoreServiceClient.listEntityTypes(
+      request,
+      {timeout: Number(timeout)}
+    );
+
+    console.log('List entity types response');
+    console.log('Raw response:');
+    console.log(JSON.stringify(response, null, 2));
+  }
+  listEntityTypes();
+  // [END aiplatform_list_entity_types_sample]
+}
+
+process.on('unhandledRejection', err => {
+  console.error(err.message);
+  process.exitCode = 1;
+});
+
+main(...process.argv.slice(2));

samples/list-entity-types-stream-sample.js

@@ -0,0 +1,94 @@
+/*
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*
+ * Lists EntityTypes using streaming in a given Featurestore.
+ * See https://cloud.google.com/vertex-ai/docs/featurestore/setup before running
+ * the code snippet
+ */
+
+'use strict';
+
+async function main(
+  project,
+  featurestoreId,
+  location = 'us-central1',
+  apiEndpoint = 'us-central1-aiplatform.googleapis.com',
+  timeout = 300000
+) {
+  // [START aiplatform_list_entity_types_stream_sample]
+  /**
+   * TODO(developer): Uncomment these variables before running the sample.\
+   * (Not necessary if passing values as arguments)
+   */
+
+  // const project = 'YOUR_PROJECT_ID';
+  // const featurestoreId = 'YOUR_FEATURESTORE_ID';
+  // const location = 'YOUR_PROJECT_LOCATION';
+  // const apiEndpoint = 'YOUR_API_ENDPOINT';
+  // const timeout = <TIMEOUT_IN_MILLI_SECONDS>;
+
+  // Imports the Google Cloud Featurestore Service Client library
+  const {FeaturestoreServiceClient} = require('@google-cloud/aiplatform').v1;
+
+  // Specifies the location of the api endpoint
+  const clientOptions = {
+    apiEndpoint: apiEndpoint,
+  };
+
+  // Instantiates a client
+  const featurestoreServiceClient = new FeaturestoreServiceClient(
+    clientOptions
+  );
+
+  async function listEntityTypesStream() {
+    // Configure the parent resource
+    const parent = `projects/${project}/locations/${location}/featurestores/${featurestoreId}`;
+
+    const request = {
+      parent: parent,
+    };
+
+    // List EntityTypes stream request
+    const streamObject = await featurestoreServiceClient.listEntityTypesStream(
+      request,
+      {timeout: Number(timeout)}
+    );
+
+    console.log('List entity types stream response');
+    console.log('Raw response:');
+    streamObject.on('data', response => {
+      console.log(JSON.stringify(response, null, 2));
+    });
+
+    streamObject.on('end', () => {
+      console.log('No more data to read');
+    });
+
+    streamObject.on('close', () => {
+      console.log('Stream object listEntityTypesStream is closed');
+    });
+  }
+  listEntityTypesStream();
+  // [END aiplatform_list_entity_types_stream_sample]
+}
+
+process.on('unhandledRejection', err => {
+  console.error(err.message);
+  process.exitCode = 1;
+});
+
+main(...process.argv.slice(2));

samples/test/list-entity-types-async-sample.test.js

@@ -0,0 +1,124 @@
+/*
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+'use strict';
+
+const {assert} = require('chai');
+const {FeaturestoreServiceClient} = require('@google-cloud/aiplatform').v1;
+const {after, before, describe, it} = require('mocha');
+const uuid = require('uuid').v4;
+const cp = require('child_process');
+const execSync = cmd => cp.execSync(cmd, {encoding: 'utf-8'});
+
+const project = process.env.CAIP_PROJECT_ID;
+const featurestoreId = `featurestore_sample_${uuid()
+  .replace(/-/g, '_')
+  .slice(10, 20)}`;
+const fixedNodeCount = 1;
+const entityTypeId = `entity_type_sample_${uuid()
+  .replace(/-/g, '_')
+  .slice(10, 20)}`;
+const entityTypeDescription =
+  'created during the list entity type async sample testing';
+const location = 'us-central1';
+const apiEndpoint = 'us-central1-aiplatform.googleapis.com';
+
+// Instantiates a featurestore clients
+const featurestoreServiceClient = new FeaturestoreServiceClient({
+  apiEndpoint: apiEndpoint,
+});
+
+const createFeaturestore = async () => {
+  // Configure the parent resource
+  const parent = `projects/${project}/locations/${location}`;
+
+  const featurestore = {
+    onlineServingConfig: {
+      fixedNodeCount: fixedNodeCount,
+    },
+  };
+
+  const request = {
+    parent: parent,
+    featurestore: featurestore,
+    featurestoreId: featurestoreId,
+  };
+
+  // Create Featurestore request
+  const [operation] = await featurestoreServiceClient.createFeaturestore(
+    request,
+    {timeout: 900000}
+  );
+  await operation.promise();
+};
+
+const deleteFeaturestore = async () => {
+  // Configure the name resource
+  const name = `projects/${project}/locations/${location}/featurestores/${featurestoreId}`;
+
+  const request = {
+    name: name,
+    force: true,
+  };
+
+  // Delete Featurestore request
+  const [operation] = await featurestoreServiceClient.deleteFeaturestore(
+    request,
+    {timeout: 60000}
+  );
+  await operation.promise();
+};
+
+const createEntityType = async () => {
+  // Configure the parent resource
+  const parent = `projects/${project}/locations/${location}/featurestores/${featurestoreId}`;
+
+  const entityType = {
+    description: entityTypeDescription,
+  };
+
+  const request = {
+    parent: parent,
+    entityTypeId: entityTypeId,
+    entityType: entityType,
+  };
+
+  // CreateEntityType request
+  const [operation] = await featurestoreServiceClient.createEntityType(
+    request,
+    {timeout: 300000}
+  );
+  await operation.promise();
+};
+
+describe('AI platform list entity types async', async function () {
+  this.retries(2);
+  before('should create the featurestore', async () => {
+    await createFeaturestore();
+  });
+  before('should create the entity type', async () => {
+    await createEntityType();
+  });
+  it('should list the entity types', async () => {
+    const stdout = execSync(
+      `node ./list-entity-types-async-sample.js ${project} ${featurestoreId} ${location} ${apiEndpoint}`
+    );
+    assert.match(stdout, /List entity types async response/);
+  });
+  after('should delete the created featurestore', async () => {
+    await deleteFeaturestore();
+  });
+});