List entries

List existing entries.

Code sample

Java

Before trying this sample, follow the Java setup instructions in the Dataplex quickstart using client libraries. For more information, see the Dataplex Java API reference documentation.

To authenticate to Dataplex, set up Application Default Credentials. For more information, see Set up authentication for a local development environment.

import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.Entry;
import com.google.cloud.dataplex.v1.EntryGroupName;
import com.google.cloud.dataplex.v1.ListEntriesRequest;
import com.google.common.collect.ImmutableList;
import java.io.IOException;
import java.util.List;

public class ListEntries {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    String projectId = "MY_PROJECT_ID";
    // Available locations: https://cloud.google.com/dataplex/docs/locations
    String location = "MY_LOCATION";
    String entryGroupId = "MY_ENTRY_GROUP_ID";

    List<Entry> entries = listEntries(projectId, location, entryGroupId);
    entries.forEach(aspectType -> System.out.println("Entry name: " + aspectType.getName()));
  }

  // Method to list Entries located in projectId, location and entryGroupId
  public static List<Entry> listEntries(String projectId, String location, String entryGroupId)
      throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (CatalogServiceClient client = CatalogServiceClient.create()) {
      ListEntriesRequest listEntriesRequest =
          ListEntriesRequest.newBuilder()
              .setParent(EntryGroupName.of(projectId, location, entryGroupId).toString())
              // A filter on the entries to return. Filters are case-sensitive.
              // You can filter the request by the following fields:
              // * entry_type
              // * entry_source.display_name
              // To learn more about filters in general, see:
              // https://cloud.google.com/sdk/gcloud/reference/topic/filters
              .setFilter("entry_type=projects/dataplex-types/locations/global/entryTypes/generic")
              .build();
      CatalogServiceClient.ListEntriesPagedResponse listEntriesResponse =
          client.listEntries(listEntriesRequest);
      // Paging is implicitly handled by .iterateAll(), all results will be returned
      return ImmutableList.copyOf(listEntriesResponse.iterateAll());
    }
  }
}

Python

Before trying this sample, follow the Python setup instructions in the Dataplex quickstart using client libraries. For more information, see the Dataplex Python API reference documentation.

To authenticate to Dataplex, set up Application Default Credentials. For more information, see Set up authentication for a local development environment.

from typing import List

from google.cloud import dataplex_v1


def list_entries(
    project_id: str, location: str, entry_group_id: str
) -> List[dataplex_v1.Entry]:
    """Method to list Entries located in project_id, location and entry_group_id"""

    # Initialize client that will be used to send requests across threads. This
    # client only needs to be created once, and can be reused for multiple requests.
    # After completing all of your requests, call the "__exit__()" method to safely
    # clean up any remaining background resources. Alternatively, use the client as
    # a context manager.
    with dataplex_v1.CatalogServiceClient() as client:
        # The resource name of the Entries location
        parent = (
            f"projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}"
        )
        list_entries_request = dataplex_v1.ListEntriesRequest(
            parent=parent,
            # A filter on the entries to return. Filters are case-sensitive.
            # You can filter the request by the following fields:
            # * entry_type
            # * entry_source.display_name
            # To learn more about filters in general, see:
            # https://cloud.google.com/sdk/gcloud/reference/topic/filters
            filter="entry_type=projects/dataplex-types/locations/global/entryTypes/generic",
        )

        results = client.list_entries(request=list_entries_request)
        return list(results)


if __name__ == "__main__":
    # TODO(developer): Replace these variables before running the sample.
    project_id = "MY_PROJECT_ID"
    # Available locations: https://cloud.google.com/dataplex/docs/locations
    location = "MY_LOCATION"
    entry_group_id = "MY_ENTRY_GROUP_ID"

    entries = list_entries(project_id, location, entry_group_id)
    for entry in entries:
        print(f"Entry name: {entry.name}")

What's next

To search and filter code samples for other Google Cloud products, see the Google Cloud sample browser.