Thanks to visit codestin.com
Credit goes to github.com

Skip to content

docs: Updating dataplex documentation to include new syntax for semantic se… #2165

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
divitwork wants to merge 6 commits into
base: main
Choose a base branch
from
Open

docs: Updating dataplex documentation to include new syntax for semantic se… #2165

divitwork wants to merge 6 commits into from
+51 −16

Conversation

@divitwork
Copy link
Contributor

@divitwork divitwork commented Dec 12, 2025

…arch

Description

Dataplex.md is currently misaligned with the Dataplex backend, leading to failed search queries.

PR Checklist

Thank you for opening a Pull Request! Before submitting your PR, there are a
few things you can do to make sure it goes smoothly:

  • Make sure you reviewed
    CONTRIBUTING.md
  • [] Make sure to open an issue as a
    bug/issue
    before writing your code! That way we can discuss the change, evaluate
    designs, and agree on the general idea
  • [x ] Ensure the tests and linter pass
  • Code coverage does not decrease (if any source code was changed)
  • Appropriate docs were updated (if necessary)
  • Make sure to add ! if this involve a breaking change

🛠️ Fixes #<issue_number_goes_here>

@divitwork divitwork requested a review from a team as a code owner December 12, 2025 07:08
@gemini-code-assist
Copy link
Contributor

gemini-code-assist bot commented Dec 12, 2025

Summary of Changes

Hello @divitwork, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request addresses a misalignment between the Dataplex documentation and its backend, which was causing semantic search queries to fail. The changes update the documentation to reflect the correct syntax for aspect searches, introducing has: and has= operators, and provide comprehensive examples for both system and custom aspect types. Additionally, it introduces and explains an abbreviated syntax for logical OR and AND operations, ensuring users can construct accurate and effective search queries.

Highlights

  • Updated Aspect Search Syntax: The documentation for aspect search queries has been updated to reflect the current backend syntax, replacing aspect:x and aspect=x with has:x and has=x respectively.
  • Expanded Aspect Type Examples: New detailed examples have been added for constructing aspect search queries, differentiating between system and custom aspect types, including their respective syntax formats.
  • Introduced Abbreviated Search Syntax: A new section has been added to document an abbreviated search syntax, allowing the use of | for OR and , for AND operators in queries for improved conciseness.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

gemini-code-assist[bot]
gemini-code-assist bot reviewed Dec 12, 2025
View reviewed changes
Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the Dataplex documentation to reflect the new syntax for semantic search and adds information about abbreviated search syntax. The changes are clear and align with the goal of correcting outdated documentation. I've provided a couple of minor suggestions to improve markdown formatting for better readability and consistency.

divitwork and others added 3 commits December 15, 2025 10:32
@divitwork @gemini-code-assist
Update docs/en/resources/sources/dataplex.md
cacea4e 
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
@divitwork @gemini-code-assist
Update docs/en/resources/sources/dataplex.md
2ef970f 
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
@divitwork
Merge branch 'main' into update-dataplex-doc
dd0e1c6
@averikitsch averikitsch changed the title Updating dataplex documentation to include new syntax for semantic se… docs: Updating dataplex documentation to include new syntax for semantic se… Dec 18, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@averikitsch averikitsch averikitsch approved these changes

+1 more reviewer

@gemini-code-assist gemini-code-assist[bot] gemini-code-assist[bot] left review comments

Reviewers whose approvals may not affect merge requirements

Assignees

@duwenxin99 duwenxin99

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@divitwork @averikitsch @duwenxin99