AWS glue documentation change
Summary
Updated documentation to replace 'AWS CloudFormation' with 'CloudFormation' throughout the document for consistency in terminology
Security assessment
The changes are purely branding/terminology updates (removing redundant 'AWS' prefix from CloudFormation references). No security-related content was added, modified, or removed. Existing security context about IAM permissions remains unchanged.
Diff
diff --git a/glue/latest/dg/populate-with-cloudformation-templates.md b/glue/latest/dg/populate-with-cloudformation-templates.md index c13d288ed..28ff9542a 100644 --- a//glue/latest/dg/populate-with-cloudformation-templates.md +++ b//glue/latest/dg/populate-with-cloudformation-templates.md @@ -9 +9 @@ Sample databaseSample database, table, partitionsSample grok classifierSample JS -AWS CloudFormation is a service that can create many AWS resources. AWS Glue provides API operations to create objects in the AWS Glue Data Catalog. However, it might be more convenient to define and create AWS Glue objects and other related AWS resource objects in an AWS CloudFormation template file. Then you can automate the process of creating the objects. +CloudFormation is a service that can create many AWS resources. AWS Glue provides API operations to create objects in the AWS Glue Data Catalog. However, it might be more convenient to define and create AWS Glue objects and other related AWS resource objects in an CloudFormation template file. Then you can automate the process of creating the objects. @@ -11 +11 @@ AWS CloudFormation is a service that can create many AWS resources. AWS Glue pro -AWS CloudFormation provides a simplified syntax—either JSON (JavaScript Object Notation) or YAML (YAML Ain't Markup Language)—to express the creation of AWS resources. You can use AWS CloudFormation templates to define Data Catalog objects such as databases, tables, partitions, crawlers, classifiers, and connections. You can also define ETL objects such as jobs, triggers, and development endpoints. You create a template that describes all the AWS resources you want, and AWS CloudFormation takes care of provisioning and configuring those resources for you. +CloudFormation provides a simplified syntax—either JSON (JavaScript Object Notation) or YAML (YAML Ain't Markup Language)—to express the creation of AWS resources. You can use CloudFormation templates to define Data Catalog objects such as databases, tables, partitions, crawlers, classifiers, and connections. You can also define ETL objects such as jobs, triggers, and development endpoints. You create a template that describes all the AWS resources you want, and CloudFormation takes care of provisioning and configuring those resources for you. @@ -15 +15 @@ For more information, see [What Is AWS CloudFormation?](https://docs.aws.amazon. -If you plan to use AWS CloudFormation templates that are compatible with AWS Glue, as an administrator, you must grant access to AWS CloudFormation and to the AWS services and actions on which it depends. To grant permissions to create AWS CloudFormation resources, attach the following policy to users that work with AWS CloudFormation: +If you plan to use CloudFormation templates that are compatible with AWS Glue, as an administrator, you must grant access to CloudFormation and to the AWS services and actions on which it depends. To grant permissions to create CloudFormation resources, attach the following policy to users that work with CloudFormation: @@ -38 +38 @@ JSON -The following table contains the actions that an AWS CloudFormation template can perform on your behalf. It includes links to information about the AWS resource types and their property types that you can add to an AWS CloudFormation template. +The following table contains the actions that an CloudFormation template can perform on your behalf. It includes links to information about the AWS resource types and their property types that you can add to an CloudFormation template. @@ -40 +40 @@ The following table contains the actions that an AWS CloudFormation template can -AWS Glue resource | AWS CloudFormation template | AWS Glue samples +AWS Glue resource | CloudFormation template | AWS Glue samples @@ -54 +54 @@ Trigger | [AWS::Glue::Trigger](https://docs.aws.amazon.com/AWSCloudFormation/lat -To get started, use the following sample templates and customize them with your own metadata. Then use the AWS CloudFormation console to create an AWS CloudFormation stack to add objects to AWS Glue and any associated services. Many fields in an AWS Glue object are optional. These templates illustrate the fields that are required or are necessary for a working and functional AWS Glue object. +To get started, use the following sample templates and customize them with your own metadata. Then use the CloudFormation console to create an CloudFormation stack to add objects to AWS Glue and any associated services. Many fields in an AWS Glue object are optional. These templates illustrate the fields that are required or are necessary for a working and functional AWS Glue object. @@ -56 +56 @@ To get started, use the following sample templates and customize them with your -An AWS CloudFormation template can be in either JSON or YAML format. In these examples, YAML is used for easier readability. The examples contain comments (`#`) to describe the values that are defined in the templates. +An CloudFormation template can be in either JSON or YAML format. In these examples, YAML is used for easier readability. The examples contain comments (`#`) to describe the values that are defined in the templates. @@ -58 +58 @@ An AWS CloudFormation template can be in either JSON or YAML format. In these ex -AWS CloudFormation templates can include a `Parameters` section. This section can be changed in the sample text or when the YAML file is submitted to the AWS CloudFormation console to create a stack. The `Resources` section of the template contains the definition of AWS Glue and related objects. AWS CloudFormation template syntax definitions might contain properties that include more detailed property syntax. Not all properties might be required to create an AWS Glue object. These samples show example values for common properties to create an AWS Glue object. +CloudFormation templates can include a `Parameters` section. This section can be changed in the sample text or when the YAML file is submitted to the CloudFormation console to create a stack. The `Resources` section of the template contains the definition of AWS Glue and related objects. CloudFormation template syntax definitions might contain properties that include more detailed property syntax. Not all properties might be required to create an AWS Glue object. These samples show example values for common properties to create an AWS Glue object. @@ -60 +60 @@ AWS CloudFormation templates can include a `Parameters` section. This section ca -## Sample AWS CloudFormation template for an AWS Glue database +## Sample CloudFormation template for an AWS Glue database @@ -62 +62 @@ AWS CloudFormation templates can include a `Parameters` section. This section ca -An AWS Glue database in the Data Catalog contains metadata tables. The database consists of very few properties and can be created in the Data Catalog with an AWS CloudFormation template. The following sample template is provided to get you started and to illustrate the use of AWS CloudFormation stacks with AWS Glue. The only resource created by the sample template is a database named `cfn-mysampledatabase`. You can change it by editing the text of the sample or changing the value on the AWS CloudFormation console when you submit the YAML. +An AWS Glue database in the Data Catalog contains metadata tables. The database consists of very few properties and can be created in the Data Catalog with an CloudFormation template. The following sample template is provided to get you started and to illustrate the use of CloudFormation stacks with AWS Glue. The only resource created by the sample template is a database named `cfn-mysampledatabase`. You can change it by editing the text of the sample or changing the value on the CloudFormation console when you submit the YAML. @@ -64 +64 @@ An AWS Glue database in the Data Catalog contains metadata tables. The database -The following shows example values for common properties to create an AWS Glue database. For more information about the AWS CloudFormation database template for AWS Glue, see [AWS::Glue::Database](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-glue-database.html). +The following shows example values for common properties to create an AWS Glue database. For more information about the CloudFormation database template for AWS Glue, see [AWS::Glue::Database](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-glue-database.html). @@ -95 +95 @@ The following shows example values for common properties to create an AWS Glue d -## Sample AWS CloudFormation template for an AWS Glue database, table, and partition +## Sample CloudFormation template for an AWS Glue database, table, and partition @@ -99 +99 @@ An AWS Glue table contains the metadata that defines the structure and location -The following sample shows how to populate a database, a table, and partitions using an AWS CloudFormation template. The base data format is `csv` and delimited by a comma (,). Because a database must exist before it can contain a table, and a table must exist before partitions can be created, the template uses the `DependsOn` statement to define the dependency of these objects when they are created. +The following sample shows how to populate a database, a table, and partitions using an CloudFormation template. The base data format is `csv` and delimited by a comma (,). Because a database must exist before it can contain a table, and a table must exist before partitions can be created, the template uses the `DependsOn` statement to define the dependency of these objects when they are created. @@ -261 +261 @@ The values in this sample define a table that contains flight data from a public -## Sample AWS CloudFormation template for an AWS Glue grok classifier +## Sample CloudFormation template for an AWS Glue grok classifier @@ -295 +295 @@ This sample creates a classifier that creates a schema with one column named `me -## Sample AWS CloudFormation template for an AWS Glue JSON classifier +## Sample CloudFormation template for an AWS Glue JSON classifier @@ -329 +329 @@ This sample creates a classifier that creates a schema with each record in the ` -## Sample AWS CloudFormation template for an AWS Glue XML classifier +## Sample CloudFormation template for an AWS Glue XML classifier @@ -362 +362 @@ This sample creates a classifier that creates a schema with each record in the ` -## Sample AWS CloudFormation template for an AWS Glue crawler for Amazon S3 +## Sample CloudFormation template for an AWS Glue crawler for Amazon S3 @@ -368 +368 @@ This sample creates a crawler, the required IAM role, and an AWS Glue database i -When you submit this sample to the AWS CloudFormation console, you must confirm that you want to create the IAM role. +When you submit this sample to the CloudFormation console, you must confirm that you want to create the IAM role. @@ -446 +446 @@ When you submit this sample to the AWS CloudFormation console, you must confirm -## Sample AWS CloudFormation template for an AWS Glue connection +## Sample CloudFormation template for an AWS Glue connection @@ -499 +499 @@ This sample creates a connection to an Amazon RDS MySQL database named `devdb`. -## Sample AWS CloudFormation template for an AWS Glue crawler for JDBC +## Sample CloudFormation template for an AWS Glue crawler for JDBC @@ -505 +505 @@ This sample creates a crawler, required IAM role, and an AWS Glue database in th -When you submit this sample to the AWS CloudFormation console, you must confirm that you want to create the IAM role. +When you submit this sample to the CloudFormation console, you must confirm that you want to create the IAM role. @@ -595 +595 @@ When you submit this sample to the AWS CloudFormation console, you must confirm -## Sample AWS CloudFormation template for an AWS Glue job for Amazon S3 to Amazon S3 +## Sample CloudFormation template for an AWS Glue job for Amazon S3 to Amazon S3 @@ -652 +652 @@ Common parameter values are shown in the template. For example, `AllocatedCapaci -## Sample AWS CloudFormation template for an AWS Glue job for JDBC to Amazon S3 +## Sample CloudFormation template for an AWS Glue job for JDBC to Amazon S3 @@ -714 +714 @@ Common parameter values are shown in the template. For example, `AllocatedCapaci -## Sample AWS CloudFormation template for an AWS Glue on-demand trigger +## Sample CloudFormation template for an AWS Glue on-demand trigger @@ -755 +755 @@ This sample creates an on-demand trigger that starts one job named `cfn-job-S3-t -## Sample AWS CloudFormation template for an AWS Glue scheduled trigger +## Sample CloudFormation template for an AWS Glue scheduled trigger @@ -798 +798 @@ This sample creates a scheduled trigger that starts one job named `cfn-job-S3-to -## Sample AWS CloudFormation template for an AWS Glue conditional trigger +## Sample CloudFormation template for an AWS Glue conditional trigger @@ -847 +847 @@ This sample creates a conditional trigger that starts one job named `cfn-job-S3- -## Sample AWS CloudFormation template for an AWS Glue development endpoint +## Sample CloudFormation template for an AWS Glue development endpoint @@ -893 +893 @@ This sample creates a machine learning transform. For more information about the -## Sample AWS CloudFormation template for an AWS Glue Data Quality ruleset +## Sample CloudFormation template for an AWS Glue Data Quality ruleset @@ -947 +947 @@ The following sample is a CloudFormation template which creates a ruleset with a -## Sample AWS CloudFormation template for an AWS Glue Data Quality ruleset with EventBridge scheduler +## Sample CloudFormation template for an AWS Glue Data Quality ruleset with EventBridge scheduler @@ -1031 +1031 @@ The following sample is a CloudFormation template which creates a Data Quality r -## Sample AWS CloudFormation template for an AWS Glue development endpoint +## Sample CloudFormation template for an AWS Glue development endpoint @@ -1041 +1041 @@ You provide an existing IAM role ARN (Amazon Resource Name) to create the develo -For any notebook server that you create that is associated with a development endpoint, you manage it. Therefore, if you delete the development endpoint, to delete the notebook server, you must delete the AWS CloudFormation stack on the AWS CloudFormation console. +For any notebook server that you create that is associated with a development endpoint, you manage it. Therefore, if you delete the development endpoint, to delete the notebook server, you must delete the CloudFormation stack on the CloudFormation console.