From bd1471e5f4cf3ffce13f7b2907dd8604c5697a00 Mon Sep 17 00:00:00 2001 From: Jeff Kinard Date: Fri, 22 Nov 2024 09:47:12 -0500 Subject: [PATCH] [yaml] Enrichment transform doc improvements (#33186) Signed-off-by: Jeffrey Kinard --- .../apache_beam/yaml/yaml_enrichment.py | 59 ++++++++++--------- 1 file changed, 31 insertions(+), 28 deletions(-) diff --git a/sdks/python/apache_beam/yaml/yaml_enrichment.py b/sdks/python/apache_beam/yaml/yaml_enrichment.py index 9bea17f78fdd..c17f29bea90f 100644 --- a/sdks/python/apache_beam/yaml/yaml_enrichment.py +++ b/sdks/python/apache_beam/yaml/yaml_enrichment.py @@ -45,39 +45,42 @@ def enrichment_transform( enrichment_handler: str, handler_config: Dict[str, Any], timeout: Optional[float] = 30): + # pylint: disable=line-too-long + """ - The Enrichment transform allows you to dynamically - enhance elements in a pipeline by performing key-value - lookups against external services like APIs or databases. + The Enrichment transform allows one to dynamically enhance elements in a + pipeline by performing key-value lookups against external services like + APIs or databases. + + Example using BigTable: :: - Example Usage:: - - type: Enrichment - config: - enrichment_handler: 'BigTable' - handler_config: - project_id: 'apache-beam-testing' - instance_id: 'beam-test' - table_id: 'bigtable-enrichment-test' - row_key: 'product_id' - timeout: 30 + config: + enrichment_handler: 'BigTable' + handler_config: + project_id: 'apache-beam-testing' + instance_id: 'beam-test' + table_id: 'bigtable-enrichment-test' + row_key: 'product_id' + timeout: 30 + + For more information on Enrichment, see the [Beam docs]( + https://beam.apache.org/documentation/transforms/python/elementwise/enrichment/). Args: - enrichment_handler: Specifies the source from - where data needs to be extracted - into the pipeline for enriching data. - It can be a string value in ["BigQuery", - "BigTable", "FeastFeatureStore", - "VertexAIFeatureStore"]. - handler_config: Specifies the parameters for - the respective enrichment_handler in a dictionary format. - To see the full set of handler_config parameters, see - their corresponding doc pages: - - - :class:`~apache_beam.transforms.enrichment_handlers.bigquery.BigQueryEnrichmentHandler` # pylint: disable=line-too-long - - :class:`~apache_beam.transforms.enrichment_handlers.bigtable.BigTableEnrichmentHandler` # pylint: disable=line-too-long - - :class:`~apache_beam.transforms.enrichment_handlers.feast_feature_store.FeastFeatureStoreEnrichmentHandler` # pylint: disable=line-too-long - - :class:`~apache_beam.transforms.enrichment_handlers.vertex_ai_feature_store.VertexAIFeatureStoreEnrichmentHandler` # pylint: disable=line-too-long + enrichment_handler (str): Specifies the source from where data needs + to be extracted into the pipeline for enriching data. One of + "BigQuery", "BigTable", "FeastFeatureStore" or "VertexAIFeatureStore". + handler_config (str): Specifies the parameters for the respective + enrichment_handler in a YAML/JSON format. To see the full set of + handler_config parameters, see their corresponding doc pages: + + - [BigQueryEnrichmentHandler](https://beam.apache.org/releases/pydoc/current/apache_beam.transforms.enrichment_handlers.bigquery.html#apache_beam.transforms.enrichment_handlers.bigquery.BigQueryEnrichmentHandler) + - [BigTableEnrichmentHandler](https://beam.apache.org/releases/pydoc/current/apache_beam.transforms.enrichment_handlers.bigtable.html#apache_beam.transforms.enrichment_handlers.bigtable.BigTableEnrichmentHandler) + - [FeastFeatureStoreEnrichmentHandler](https://beam.apache.org/releases/pydoc/current/apache_beam.transforms.enrichment_handlers.feast_feature_store.html#apache_beam.transforms.enrichment_handlers.feast_feature_store.FeastFeatureStoreEnrichmentHandler) + - [VertexAIFeatureStoreEnrichmentHandler](https://beam.apache.org/releases/pydoc/current/apache_beam.transforms.enrichment_handlers.vertex_ai_feature_store.html#apache_beam.transforms.enrichment_handlers.vertex_ai_feature_store.VertexAIFeatureStoreEnrichmentHandler) + timeout (float): Timeout for source requests in seconds. Defaults to 30 + seconds. """ options.YamlOptions.check_enabled(pcoll.pipeline, 'Enrichment')