[HUDI-6857] Update BigQuerySyncTool docs

[the-other-tim-brown]

Change Logs

• Adds context around the new manifest based approach to the sync and the benefits.
• Updates the configuration to show use manifest option
• Adds additional context around partition handling

Impact

Better docs

Risk level (write none, low medium or high below)

None

Documentation Update

Describe any necessary documentation update if there is any new feature, config, or user-facing change

• The config description must be updated if new configs are added or the default value of the configs are changed
• Any new feature or user-facing change requires updating the Hudi website. Please create a Jira ticket, attach the
  ticket number here and follow the instruction to make
  changes to the website.

Contributor's checklist

• Read through contributor's guide
• Change Logs and Impact were stated clearly
• Adequate tests were added if applicable
• CI passed

[the-other-tim-brown]

I don't see this option in the hudi docs so I removed it. Also we don't use this internally when running the sync tool. Anyone know what this may have been for?

[nsivabalan]

yeah. each hudi partition has a metadata file called .hoodie_partition_metadata. this has to be in parquet format just for BQ sync purpose. for other query engines or metastores, we did not have this requirement.
So, this meta file will be just a text file in general. but if user prefers to sync to BQ, the recommendation is to enable this

[nsivabalan]

few minor comments

[nsivabalan]

yeah. each hudi partition has a metadata file called .hoodie_partition_metadata. this has to be in parquet format just for BQ sync purpose. for other query engines or metastores, we did not have this requirement.
So, this meta file will be just a text file in general. but if user prefers to sync to BQ, the recommendation is to enable this