aws-sdk-glue 1.168.0 → 1.170.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 026570f735cc31dc048fa519615948aea016bdac983aef531560d119747d4a9a
4
- data.tar.gz: ab99177e6675725fcebe82dc48d385e5b37bacb4f1cd52b8a33f787a2097ccf4
3
+ metadata.gz: 99e40064401700d88dbc4ef06c8e912d49c93454c600631373ae867ca47fd68b
4
+ data.tar.gz: 45c5acccff36198cefbb69ecb11b4ea97dfdb07ba2fb516747db8718b79714b1
5
5
  SHA512:
6
- metadata.gz: bca8ba8d27256fc7adca1b069a5323c571ba3c9b89c37051e28eeca9e06c7624a96eb36779f2d76f2c1d31e1a88ab2751c69560a6825104c8a5224e5548b64ce
7
- data.tar.gz: 5afab594d2120a1ac10a016312cb63caaca021678abc345d2d97144192b6176203964a3b2fdfee3aae19426ae2726e0adffedcca52592a45a4682618a192a13d
6
+ metadata.gz: f14e38199d0586de50a930a426d3790cf01c7541476da2bdeb6a6ce337cf5af1270ac5f0be1ea7c79eca14ed2e1aa5b09ccd5aec794a5edcfa0f59e2233575db
7
+ data.tar.gz: d3e1261064990a71394172998b37a1f62c9002887e6c8b9aed4c3a5da377d5c8d30776ae8099bf85d2dacb77a1f3dc37611662ab92ef2082538991223d1d8ebb
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.170.0 (2024-04-12)
5
+ ------------------
6
+
7
+ * Feature - Modifying request for GetUnfilteredTableMetadata for view-related fields.
8
+
9
+ 1.169.0 (2024-04-02)
10
+ ------------------
11
+
12
+ * Feature - Adding View related fields to responses of read-only Table APIs.
13
+
4
14
  1.168.0 (2024-02-05)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.168.0
1
+ 1.170.0
@@ -10826,6 +10826,17 @@ module Aws::Glue
10826
10826
  # resp.table.federated_table.identifier #=> String
10827
10827
  # resp.table.federated_table.database_identifier #=> String
10828
10828
  # resp.table.federated_table.connection_name #=> String
10829
+ # resp.table.view_definition.is_protected #=> Boolean
10830
+ # resp.table.view_definition.definer #=> String
10831
+ # resp.table.view_definition.sub_objects #=> Array
10832
+ # resp.table.view_definition.sub_objects[0] #=> String
10833
+ # resp.table.view_definition.representations #=> Array
10834
+ # resp.table.view_definition.representations[0].dialect #=> String, one of "REDSHIFT", "ATHENA", "SPARK"
10835
+ # resp.table.view_definition.representations[0].dialect_version #=> String
10836
+ # resp.table.view_definition.representations[0].view_original_text #=> String
10837
+ # resp.table.view_definition.representations[0].view_expanded_text #=> String
10838
+ # resp.table.view_definition.representations[0].is_stale #=> Boolean
10839
+ # resp.table.is_multi_dialect_view #=> Boolean
10829
10840
  #
10830
10841
  # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/GetTable AWS API Documentation
10831
10842
  #
@@ -10993,6 +11004,17 @@ module Aws::Glue
10993
11004
  # resp.table_version.table.federated_table.identifier #=> String
10994
11005
  # resp.table_version.table.federated_table.database_identifier #=> String
10995
11006
  # resp.table_version.table.federated_table.connection_name #=> String
11007
+ # resp.table_version.table.view_definition.is_protected #=> Boolean
11008
+ # resp.table_version.table.view_definition.definer #=> String
11009
+ # resp.table_version.table.view_definition.sub_objects #=> Array
11010
+ # resp.table_version.table.view_definition.sub_objects[0] #=> String
11011
+ # resp.table_version.table.view_definition.representations #=> Array
11012
+ # resp.table_version.table.view_definition.representations[0].dialect #=> String, one of "REDSHIFT", "ATHENA", "SPARK"
11013
+ # resp.table_version.table.view_definition.representations[0].dialect_version #=> String
11014
+ # resp.table_version.table.view_definition.representations[0].view_original_text #=> String
11015
+ # resp.table_version.table.view_definition.representations[0].view_expanded_text #=> String
11016
+ # resp.table_version.table.view_definition.representations[0].is_stale #=> Boolean
11017
+ # resp.table_version.table.is_multi_dialect_view #=> Boolean
10996
11018
  # resp.table_version.version_id #=> String
10997
11019
  #
10998
11020
  # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/GetTableVersion AWS API Documentation
@@ -11112,6 +11134,17 @@ module Aws::Glue
11112
11134
  # resp.table_versions[0].table.federated_table.identifier #=> String
11113
11135
  # resp.table_versions[0].table.federated_table.database_identifier #=> String
11114
11136
  # resp.table_versions[0].table.federated_table.connection_name #=> String
11137
+ # resp.table_versions[0].table.view_definition.is_protected #=> Boolean
11138
+ # resp.table_versions[0].table.view_definition.definer #=> String
11139
+ # resp.table_versions[0].table.view_definition.sub_objects #=> Array
11140
+ # resp.table_versions[0].table.view_definition.sub_objects[0] #=> String
11141
+ # resp.table_versions[0].table.view_definition.representations #=> Array
11142
+ # resp.table_versions[0].table.view_definition.representations[0].dialect #=> String, one of "REDSHIFT", "ATHENA", "SPARK"
11143
+ # resp.table_versions[0].table.view_definition.representations[0].dialect_version #=> String
11144
+ # resp.table_versions[0].table.view_definition.representations[0].view_original_text #=> String
11145
+ # resp.table_versions[0].table.view_definition.representations[0].view_expanded_text #=> String
11146
+ # resp.table_versions[0].table.view_definition.representations[0].is_stale #=> Boolean
11147
+ # resp.table_versions[0].table.is_multi_dialect_view #=> Boolean
11115
11148
  # resp.table_versions[0].version_id #=> String
11116
11149
  # resp.next_token #=> String
11117
11150
  #
@@ -11242,6 +11275,17 @@ module Aws::Glue
11242
11275
  # resp.table_list[0].federated_table.identifier #=> String
11243
11276
  # resp.table_list[0].federated_table.database_identifier #=> String
11244
11277
  # resp.table_list[0].federated_table.connection_name #=> String
11278
+ # resp.table_list[0].view_definition.is_protected #=> Boolean
11279
+ # resp.table_list[0].view_definition.definer #=> String
11280
+ # resp.table_list[0].view_definition.sub_objects #=> Array
11281
+ # resp.table_list[0].view_definition.sub_objects[0] #=> String
11282
+ # resp.table_list[0].view_definition.representations #=> Array
11283
+ # resp.table_list[0].view_definition.representations[0].dialect #=> String, one of "REDSHIFT", "ATHENA", "SPARK"
11284
+ # resp.table_list[0].view_definition.representations[0].dialect_version #=> String
11285
+ # resp.table_list[0].view_definition.representations[0].view_original_text #=> String
11286
+ # resp.table_list[0].view_definition.representations[0].view_expanded_text #=> String
11287
+ # resp.table_list[0].view_definition.representations[0].is_stale #=> Boolean
11288
+ # resp.table_list[0].is_multi_dialect_view #=> Boolean
11245
11289
  # resp.next_token #=> String
11246
11290
  #
11247
11291
  # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/GetTables AWS API Documentation
@@ -11757,8 +11801,8 @@ module Aws::Glue
11757
11801
  req.send_request(options)
11758
11802
  end
11759
11803
 
11760
- # Retrieves table metadata from the Data Catalog that contains
11761
- # unfiltered metadata.
11804
+ # Allows a third-party analytical engine to retrieve unfiltered table
11805
+ # metadata from the Data Catalog.
11762
11806
  #
11763
11807
  # For IAM authorization, the public IAM action associated with this API
11764
11808
  # is `glue:GetTable`.
@@ -11781,7 +11825,46 @@ module Aws::Glue
11781
11825
  # A structure containing Lake Formation audit context information.
11782
11826
  #
11783
11827
  # @option params [required, Array<String>] :supported_permission_types
11784
- # (Required) A list of supported permission types.
11828
+ # Indicates the level of filtering a third-party analytical engine is
11829
+ # capable of enforcing when calling the `GetUnfilteredTableMetadata` API
11830
+ # operation. Accepted values are:
11831
+ #
11832
+ # * `COLUMN_PERMISSION` - Column permissions ensure that users can
11833
+ # access only specific columns in the table. If there are particular
11834
+ # columns contain sensitive data, data lake administrators can define
11835
+ # column filters that exclude access to specific columns.
11836
+ #
11837
+ # * `CELL_FILTER_PERMISSION` - Cell-level filtering combines column
11838
+ # filtering (include or exclude columns) and row filter expressions to
11839
+ # restrict access to individual elements in the table.
11840
+ #
11841
+ # * `NESTED_PERMISSION` - Nested permissions combines cell-level
11842
+ # filtering and nested column filtering to restrict access to columns
11843
+ # and/or nested columns in specific rows based on row filter
11844
+ # expressions.
11845
+ #
11846
+ # * `NESTED_CELL_PERMISSION` - Nested cell permissions combines nested
11847
+ # permission with nested cell-level filtering. This allows different
11848
+ # subsets of nested columns to be restricted based on an array of row
11849
+ # filter expressions.
11850
+ #
11851
+ # Note: Each of these permission types follows a hierarchical order
11852
+ # where each subsequent permission type includes all permission of the
11853
+ # previous type.
11854
+ #
11855
+ # Important: If you provide a supported permission type that doesn't
11856
+ # match the user's level of permissions on the table, then Lake
11857
+ # Formation raises an exception. For example, if the third-party engine
11858
+ # calling the `GetUnfilteredTableMetadata` operation can enforce only
11859
+ # column-level filtering, and the user has nested cell filtering applied
11860
+ # on the table, Lake Formation throws an exception, and will not return
11861
+ # unfiltered table metadata and data access credentials.
11862
+ #
11863
+ # @option params [String] :parent_resource_arn
11864
+ # The resource ARN of the view.
11865
+ #
11866
+ # @option params [String] :root_resource_arn
11867
+ # The resource ARN of the root view in a chain of nested views.
11785
11868
  #
11786
11869
  # @option params [Types::SupportedDialect] :supported_dialect
11787
11870
  # A structure specifying the dialect and dialect version used by the
@@ -11804,7 +11887,9 @@ module Aws::Glue
11804
11887
  # * {Types::GetUnfilteredTableMetadataResponse#is_registered_with_lake_formation #is_registered_with_lake_formation} => Boolean
11805
11888
  # * {Types::GetUnfilteredTableMetadataResponse#cell_filters #cell_filters} => Array&lt;Types::ColumnRowFilter&gt;
11806
11889
  # * {Types::GetUnfilteredTableMetadataResponse#query_authorization_id #query_authorization_id} => String
11890
+ # * {Types::GetUnfilteredTableMetadataResponse#is_multi_dialect_view #is_multi_dialect_view} => Boolean
11807
11891
  # * {Types::GetUnfilteredTableMetadataResponse#resource_arn #resource_arn} => String
11892
+ # * {Types::GetUnfilteredTableMetadataResponse#is_protected #is_protected} => Boolean
11808
11893
  # * {Types::GetUnfilteredTableMetadataResponse#permissions #permissions} => Array&lt;String&gt;
11809
11894
  #
11810
11895
  # @example Request syntax with placeholder values
@@ -11820,6 +11905,8 @@ module Aws::Glue
11820
11905
  # all_columns_requested: false,
11821
11906
  # },
11822
11907
  # supported_permission_types: ["COLUMN_PERMISSION"], # required, accepts COLUMN_PERMISSION, CELL_FILTER_PERMISSION, NESTED_PERMISSION, NESTED_CELL_PERMISSION
11908
+ # parent_resource_arn: "ArnString",
11909
+ # root_resource_arn: "ArnString",
11823
11910
  # supported_dialect: {
11824
11911
  # dialect: "REDSHIFT", # accepts REDSHIFT, ATHENA, SPARK
11825
11912
  # dialect_version: "ViewDialectVersionString",
@@ -11905,6 +11992,17 @@ module Aws::Glue
11905
11992
  # resp.table.federated_table.identifier #=> String
11906
11993
  # resp.table.federated_table.database_identifier #=> String
11907
11994
  # resp.table.federated_table.connection_name #=> String
11995
+ # resp.table.view_definition.is_protected #=> Boolean
11996
+ # resp.table.view_definition.definer #=> String
11997
+ # resp.table.view_definition.sub_objects #=> Array
11998
+ # resp.table.view_definition.sub_objects[0] #=> String
11999
+ # resp.table.view_definition.representations #=> Array
12000
+ # resp.table.view_definition.representations[0].dialect #=> String, one of "REDSHIFT", "ATHENA", "SPARK"
12001
+ # resp.table.view_definition.representations[0].dialect_version #=> String
12002
+ # resp.table.view_definition.representations[0].view_original_text #=> String
12003
+ # resp.table.view_definition.representations[0].view_expanded_text #=> String
12004
+ # resp.table.view_definition.representations[0].is_stale #=> Boolean
12005
+ # resp.table.is_multi_dialect_view #=> Boolean
11908
12006
  # resp.authorized_columns #=> Array
11909
12007
  # resp.authorized_columns[0] #=> String
11910
12008
  # resp.is_registered_with_lake_formation #=> Boolean
@@ -11912,7 +12010,9 @@ module Aws::Glue
11912
12010
  # resp.cell_filters[0].column_name #=> String
11913
12011
  # resp.cell_filters[0].row_filter_expression #=> String
11914
12012
  # resp.query_authorization_id #=> String
12013
+ # resp.is_multi_dialect_view #=> Boolean
11915
12014
  # resp.resource_arn #=> String
12015
+ # resp.is_protected #=> Boolean
11916
12016
  # resp.permissions #=> Array
11917
12017
  # resp.permissions[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
11918
12018
  #
@@ -14362,6 +14462,17 @@ module Aws::Glue
14362
14462
  # resp.table_list[0].federated_table.identifier #=> String
14363
14463
  # resp.table_list[0].federated_table.database_identifier #=> String
14364
14464
  # resp.table_list[0].federated_table.connection_name #=> String
14465
+ # resp.table_list[0].view_definition.is_protected #=> Boolean
14466
+ # resp.table_list[0].view_definition.definer #=> String
14467
+ # resp.table_list[0].view_definition.sub_objects #=> Array
14468
+ # resp.table_list[0].view_definition.sub_objects[0] #=> String
14469
+ # resp.table_list[0].view_definition.representations #=> Array
14470
+ # resp.table_list[0].view_definition.representations[0].dialect #=> String, one of "REDSHIFT", "ATHENA", "SPARK"
14471
+ # resp.table_list[0].view_definition.representations[0].dialect_version #=> String
14472
+ # resp.table_list[0].view_definition.representations[0].view_original_text #=> String
14473
+ # resp.table_list[0].view_definition.representations[0].view_expanded_text #=> String
14474
+ # resp.table_list[0].view_definition.representations[0].is_stale #=> Boolean
14475
+ # resp.table_list[0].is_multi_dialect_view #=> Boolean
14365
14476
  #
14366
14477
  # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/SearchTables AWS API Documentation
14367
14478
  #
@@ -17008,7 +17119,7 @@ module Aws::Glue
17008
17119
  params: params,
17009
17120
  config: config)
17010
17121
  context[:gem_name] = 'aws-sdk-glue'
17011
- context[:gem_version] = '1.168.0'
17122
+ context[:gem_version] = '1.170.0'
17012
17123
  Seahorse::Client::Request.new(handlers, context)
17013
17124
  end
17014
17125
 
@@ -1221,8 +1221,12 @@ module Aws::Glue
1221
1221
  VersionMismatchException = Shapes::StructureShape.new(name: 'VersionMismatchException')
1222
1222
  VersionString = Shapes::StringShape.new(name: 'VersionString')
1223
1223
  VersionsString = Shapes::StringShape.new(name: 'VersionsString')
1224
+ ViewDefinition = Shapes::StructureShape.new(name: 'ViewDefinition')
1224
1225
  ViewDialect = Shapes::StringShape.new(name: 'ViewDialect')
1225
1226
  ViewDialectVersionString = Shapes::StringShape.new(name: 'ViewDialectVersionString')
1227
+ ViewRepresentation = Shapes::StructureShape.new(name: 'ViewRepresentation')
1228
+ ViewRepresentationList = Shapes::ListShape.new(name: 'ViewRepresentationList')
1229
+ ViewSubObjectsList = Shapes::ListShape.new(name: 'ViewSubObjectsList')
1226
1230
  ViewTextString = Shapes::StringShape.new(name: 'ViewTextString')
1227
1231
  WorkerType = Shapes::StringShape.new(name: 'WorkerType')
1228
1232
  Workflow = Shapes::StructureShape.new(name: 'Workflow')
@@ -3671,6 +3675,8 @@ module Aws::Glue
3671
3675
  GetUnfilteredTableMetadataRequest.add_member(:name, Shapes::ShapeRef.new(shape: NameString, required: true, location_name: "Name"))
3672
3676
  GetUnfilteredTableMetadataRequest.add_member(:audit_context, Shapes::ShapeRef.new(shape: AuditContext, location_name: "AuditContext"))
3673
3677
  GetUnfilteredTableMetadataRequest.add_member(:supported_permission_types, Shapes::ShapeRef.new(shape: PermissionTypeList, required: true, location_name: "SupportedPermissionTypes"))
3678
+ GetUnfilteredTableMetadataRequest.add_member(:parent_resource_arn, Shapes::ShapeRef.new(shape: ArnString, location_name: "ParentResourceArn"))
3679
+ GetUnfilteredTableMetadataRequest.add_member(:root_resource_arn, Shapes::ShapeRef.new(shape: ArnString, location_name: "RootResourceArn"))
3674
3680
  GetUnfilteredTableMetadataRequest.add_member(:supported_dialect, Shapes::ShapeRef.new(shape: SupportedDialect, location_name: "SupportedDialect"))
3675
3681
  GetUnfilteredTableMetadataRequest.add_member(:permissions, Shapes::ShapeRef.new(shape: PermissionList, location_name: "Permissions"))
3676
3682
  GetUnfilteredTableMetadataRequest.add_member(:query_session_context, Shapes::ShapeRef.new(shape: QuerySessionContext, location_name: "QuerySessionContext"))
@@ -3681,7 +3687,9 @@ module Aws::Glue
3681
3687
  GetUnfilteredTableMetadataResponse.add_member(:is_registered_with_lake_formation, Shapes::ShapeRef.new(shape: Boolean, location_name: "IsRegisteredWithLakeFormation"))
3682
3688
  GetUnfilteredTableMetadataResponse.add_member(:cell_filters, Shapes::ShapeRef.new(shape: ColumnRowFilterList, location_name: "CellFilters"))
3683
3689
  GetUnfilteredTableMetadataResponse.add_member(:query_authorization_id, Shapes::ShapeRef.new(shape: HashString, location_name: "QueryAuthorizationId"))
3690
+ GetUnfilteredTableMetadataResponse.add_member(:is_multi_dialect_view, Shapes::ShapeRef.new(shape: Boolean, location_name: "IsMultiDialectView"))
3684
3691
  GetUnfilteredTableMetadataResponse.add_member(:resource_arn, Shapes::ShapeRef.new(shape: ArnString, location_name: "ResourceArn"))
3692
+ GetUnfilteredTableMetadataResponse.add_member(:is_protected, Shapes::ShapeRef.new(shape: Boolean, location_name: "IsProtected"))
3685
3693
  GetUnfilteredTableMetadataResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: PermissionList, location_name: "Permissions"))
3686
3694
  GetUnfilteredTableMetadataResponse.struct_class = Types::GetUnfilteredTableMetadataResponse
3687
3695
 
@@ -5392,6 +5400,8 @@ module Aws::Glue
5392
5400
  Table.add_member(:catalog_id, Shapes::ShapeRef.new(shape: CatalogIdString, location_name: "CatalogId"))
5393
5401
  Table.add_member(:version_id, Shapes::ShapeRef.new(shape: VersionString, location_name: "VersionId"))
5394
5402
  Table.add_member(:federated_table, Shapes::ShapeRef.new(shape: FederatedTable, location_name: "FederatedTable"))
5403
+ Table.add_member(:view_definition, Shapes::ShapeRef.new(shape: ViewDefinition, location_name: "ViewDefinition"))
5404
+ Table.add_member(:is_multi_dialect_view, Shapes::ShapeRef.new(shape: NullableBoolean, location_name: "IsMultiDialectView"))
5395
5405
  Table.struct_class = Types::Table
5396
5406
 
5397
5407
  TableError.add_member(:table_name, Shapes::ShapeRef.new(shape: NameString, location_name: "TableName"))
@@ -5859,6 +5869,23 @@ module Aws::Glue
5859
5869
  VersionMismatchException.add_member(:message, Shapes::ShapeRef.new(shape: MessageString, location_name: "Message"))
5860
5870
  VersionMismatchException.struct_class = Types::VersionMismatchException
5861
5871
 
5872
+ ViewDefinition.add_member(:is_protected, Shapes::ShapeRef.new(shape: NullableBoolean, location_name: "IsProtected"))
5873
+ ViewDefinition.add_member(:definer, Shapes::ShapeRef.new(shape: ArnString, location_name: "Definer"))
5874
+ ViewDefinition.add_member(:sub_objects, Shapes::ShapeRef.new(shape: ViewSubObjectsList, location_name: "SubObjects"))
5875
+ ViewDefinition.add_member(:representations, Shapes::ShapeRef.new(shape: ViewRepresentationList, location_name: "Representations"))
5876
+ ViewDefinition.struct_class = Types::ViewDefinition
5877
+
5878
+ ViewRepresentation.add_member(:dialect, Shapes::ShapeRef.new(shape: ViewDialect, location_name: "Dialect"))
5879
+ ViewRepresentation.add_member(:dialect_version, Shapes::ShapeRef.new(shape: ViewDialectVersionString, location_name: "DialectVersion"))
5880
+ ViewRepresentation.add_member(:view_original_text, Shapes::ShapeRef.new(shape: ViewTextString, location_name: "ViewOriginalText"))
5881
+ ViewRepresentation.add_member(:view_expanded_text, Shapes::ShapeRef.new(shape: ViewTextString, location_name: "ViewExpandedText"))
5882
+ ViewRepresentation.add_member(:is_stale, Shapes::ShapeRef.new(shape: NullableBoolean, location_name: "IsStale"))
5883
+ ViewRepresentation.struct_class = Types::ViewRepresentation
5884
+
5885
+ ViewRepresentationList.member = Shapes::ShapeRef.new(shape: ViewRepresentation)
5886
+
5887
+ ViewSubObjectsList.member = Shapes::ShapeRef.new(shape: ArnString)
5888
+
5862
5889
  Workflow.add_member(:name, Shapes::ShapeRef.new(shape: NameString, location_name: "Name"))
5863
5890
  Workflow.add_member(:description, Shapes::ShapeRef.new(shape: GenericString, location_name: "Description"))
5864
5891
  Workflow.add_member(:default_run_properties, Shapes::ShapeRef.new(shape: WorkflowRunProperties, location_name: "DefaultRunProperties"))
@@ -12103,9 +12103,51 @@ module Aws::Glue
12103
12103
  # @return [Types::AuditContext]
12104
12104
  #
12105
12105
  # @!attribute [rw] supported_permission_types
12106
- # (Required) A list of supported permission types.
12106
+ # Indicates the level of filtering a third-party analytical engine is
12107
+ # capable of enforcing when calling the `GetUnfilteredTableMetadata`
12108
+ # API operation. Accepted values are:
12109
+ #
12110
+ # * `COLUMN_PERMISSION` - Column permissions ensure that users can
12111
+ # access only specific columns in the table. If there are particular
12112
+ # columns contain sensitive data, data lake administrators can
12113
+ # define column filters that exclude access to specific columns.
12114
+ #
12115
+ # * `CELL_FILTER_PERMISSION` - Cell-level filtering combines column
12116
+ # filtering (include or exclude columns) and row filter expressions
12117
+ # to restrict access to individual elements in the table.
12118
+ #
12119
+ # * `NESTED_PERMISSION` - Nested permissions combines cell-level
12120
+ # filtering and nested column filtering to restrict access to
12121
+ # columns and/or nested columns in specific rows based on row filter
12122
+ # expressions.
12123
+ #
12124
+ # * `NESTED_CELL_PERMISSION` - Nested cell permissions combines nested
12125
+ # permission with nested cell-level filtering. This allows different
12126
+ # subsets of nested columns to be restricted based on an array of
12127
+ # row filter expressions.
12128
+ #
12129
+ # Note: Each of these permission types follows a hierarchical order
12130
+ # where each subsequent permission type includes all permission of the
12131
+ # previous type.
12132
+ #
12133
+ # Important: If you provide a supported permission type that doesn't
12134
+ # match the user's level of permissions on the table, then Lake
12135
+ # Formation raises an exception. For example, if the third-party
12136
+ # engine calling the `GetUnfilteredTableMetadata` operation can
12137
+ # enforce only column-level filtering, and the user has nested cell
12138
+ # filtering applied on the table, Lake Formation throws an exception,
12139
+ # and will not return unfiltered table metadata and data access
12140
+ # credentials.
12107
12141
  # @return [Array<String>]
12108
12142
  #
12143
+ # @!attribute [rw] parent_resource_arn
12144
+ # The resource ARN of the view.
12145
+ # @return [String]
12146
+ #
12147
+ # @!attribute [rw] root_resource_arn
12148
+ # The resource ARN of the root view in a chain of nested views.
12149
+ # @return [String]
12150
+ #
12109
12151
  # @!attribute [rw] supported_dialect
12110
12152
  # A structure specifying the dialect and dialect version used by the
12111
12153
  # query engine.
@@ -12132,6 +12174,8 @@ module Aws::Glue
12132
12174
  :name,
12133
12175
  :audit_context,
12134
12176
  :supported_permission_types,
12177
+ :parent_resource_arn,
12178
+ :root_resource_arn,
12135
12179
  :supported_dialect,
12136
12180
  :permissions,
12137
12181
  :query_session_context)
@@ -12161,10 +12205,23 @@ module Aws::Glue
12161
12205
  # Lake Formation.
12162
12206
  # @return [String]
12163
12207
  #
12208
+ # @!attribute [rw] is_multi_dialect_view
12209
+ # Specifies whether the view supports the SQL dialects of one or more
12210
+ # different query engines and can therefore be read by those engines.
12211
+ # @return [Boolean]
12212
+ #
12164
12213
  # @!attribute [rw] resource_arn
12165
12214
  # The resource ARN of the parent resource extracted from the request.
12166
12215
  # @return [String]
12167
12216
  #
12217
+ # @!attribute [rw] is_protected
12218
+ # A flag that instructs the engine not to push user-provided
12219
+ # operations into the logical plan of the view during query planning.
12220
+ # However, if set this flag does not guarantee that the engine will
12221
+ # comply. Refer to the engine's documentation to understand the
12222
+ # guarantees provided, if any.
12223
+ # @return [Boolean]
12224
+ #
12168
12225
  # @!attribute [rw] permissions
12169
12226
  # The Lake Formation data permissions of the caller on the table. Used
12170
12227
  # to authorize the call when no view context is found.
@@ -12178,7 +12235,9 @@ module Aws::Glue
12178
12235
  :is_registered_with_lake_formation,
12179
12236
  :cell_filters,
12180
12237
  :query_authorization_id,
12238
+ :is_multi_dialect_view,
12181
12239
  :resource_arn,
12240
+ :is_protected,
12182
12241
  :permissions)
12183
12242
  SENSITIVE = []
12184
12243
  include Aws::Structure
@@ -14351,14 +14410,19 @@ module Aws::Glue
14351
14410
  # @return [String]
14352
14411
  #
14353
14412
  # @!attribute [rw] max_fetch_time_in_ms
14354
- # The maximum time spent in the job executor to fetch a record from
14355
- # the Kinesis data stream per shard, specified in milliseconds (ms).
14356
- # The default value is `1000`.
14413
+ # The maximum time spent for the job executor to read records for the
14414
+ # current batch from the Kinesis data stream, specified in
14415
+ # milliseconds (ms). Multiple `GetRecords` API calls may be made
14416
+ # within this time. The default value is `1000`.
14357
14417
  # @return [Integer]
14358
14418
  #
14359
14419
  # @!attribute [rw] max_fetch_records_per_shard
14360
14420
  # The maximum number of records to fetch per shard in the Kinesis data
14361
- # stream. The default value is `100000`.
14421
+ # stream per microbatch. Note: The client can exceed this limit if the
14422
+ # streaming job has already read extra records from Kinesis (in the
14423
+ # same get-records call). If `MaxFetchRecordsPerShard` needs to be
14424
+ # strict then it needs to be a multiple of `MaxRecordPerRead`. The
14425
+ # default value is `100000`.
14362
14426
  # @return [Integer]
14363
14427
  #
14364
14428
  # @!attribute [rw] max_record_per_read
@@ -20850,6 +20914,16 @@ module Aws::Glue
20850
20914
  # Glue Data Catalog.
20851
20915
  # @return [Types::FederatedTable]
20852
20916
  #
20917
+ # @!attribute [rw] view_definition
20918
+ # A structure that contains all the information that defines the view,
20919
+ # including the dialect or dialects for the view, and the query.
20920
+ # @return [Types::ViewDefinition]
20921
+ #
20922
+ # @!attribute [rw] is_multi_dialect_view
20923
+ # Specifies whether the view supports the SQL dialects of one or more
20924
+ # different query engines and can therefore be read by those engines.
20925
+ # @return [Boolean]
20926
+ #
20853
20927
  # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/Table AWS API Documentation
20854
20928
  #
20855
20929
  class Table < Struct.new(
@@ -20873,7 +20947,9 @@ module Aws::Glue
20873
20947
  :target_table,
20874
20948
  :catalog_id,
20875
20949
  :version_id,
20876
- :federated_table)
20950
+ :federated_table,
20951
+ :view_definition,
20952
+ :is_multi_dialect_view)
20877
20953
  SENSITIVE = []
20878
20954
  include Aws::Structure
20879
20955
  end
@@ -23082,6 +23158,87 @@ module Aws::Glue
23082
23158
  include Aws::Structure
23083
23159
  end
23084
23160
 
23161
+ # A structure containing details for representations.
23162
+ #
23163
+ # @!attribute [rw] is_protected
23164
+ # You can set this flag as true to instruct the engine not to push
23165
+ # user-provided operations into the logical plan of the view during
23166
+ # query planning. However, setting this flag does not guarantee that
23167
+ # the engine will comply. Refer to the engine's documentation to
23168
+ # understand the guarantees provided, if any.
23169
+ # @return [Boolean]
23170
+ #
23171
+ # @!attribute [rw] definer
23172
+ # The definer of a view in SQL.
23173
+ # @return [String]
23174
+ #
23175
+ # @!attribute [rw] sub_objects
23176
+ # A list of table Amazon Resource Names (ARNs).
23177
+ # @return [Array<String>]
23178
+ #
23179
+ # @!attribute [rw] representations
23180
+ # A list of representations.
23181
+ # @return [Array<Types::ViewRepresentation>]
23182
+ #
23183
+ # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/ViewDefinition AWS API Documentation
23184
+ #
23185
+ class ViewDefinition < Struct.new(
23186
+ :is_protected,
23187
+ :definer,
23188
+ :sub_objects,
23189
+ :representations)
23190
+ SENSITIVE = []
23191
+ include Aws::Structure
23192
+ end
23193
+
23194
+ # A structure that contains the dialect of the view, and the query that
23195
+ # defines the view.
23196
+ #
23197
+ # @!attribute [rw] dialect
23198
+ # The dialect of the query engine.
23199
+ # @return [String]
23200
+ #
23201
+ # @!attribute [rw] dialect_version
23202
+ # The version of the dialect of the query engine. For example, 3.0.0.
23203
+ # @return [String]
23204
+ #
23205
+ # @!attribute [rw] view_original_text
23206
+ # The `SELECT` query provided by the customer during `CREATE VIEW
23207
+ # DDL`. This SQL is not used during a query on a view
23208
+ # (`ViewExpandedText` is used instead). `ViewOriginalText` is used for
23209
+ # cases like `SHOW CREATE VIEW` where users want to see the original
23210
+ # DDL command that created the view.
23211
+ # @return [String]
23212
+ #
23213
+ # @!attribute [rw] view_expanded_text
23214
+ # The expanded SQL for the view. This SQL is used by engines while
23215
+ # processing a query on a view. Engines may perform operations during
23216
+ # view creation to transform `ViewOriginalText` to `ViewExpandedText`.
23217
+ # For example:
23218
+ #
23219
+ # * Fully qualify identifiers: `SELECT * from table1 → SELECT * from
23220
+ # db1.table1`
23221
+ #
23222
+ # ^
23223
+ # @return [String]
23224
+ #
23225
+ # @!attribute [rw] is_stale
23226
+ # Dialects marked as stale are no longer valid and must be updated
23227
+ # before they can be queried in their respective query engines.
23228
+ # @return [Boolean]
23229
+ #
23230
+ # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/ViewRepresentation AWS API Documentation
23231
+ #
23232
+ class ViewRepresentation < Struct.new(
23233
+ :dialect,
23234
+ :dialect_version,
23235
+ :view_original_text,
23236
+ :view_expanded_text,
23237
+ :is_stale)
23238
+ SENSITIVE = []
23239
+ include Aws::Structure
23240
+ end
23241
+
23085
23242
  # A workflow is a collection of multiple dependent Glue jobs and
23086
23243
  # crawlers that are run to complete a complex ETL task. A workflow
23087
23244
  # manages the execution and monitoring of all its jobs and crawlers.
data/lib/aws-sdk-glue.rb CHANGED
@@ -52,6 +52,6 @@ require_relative 'aws-sdk-glue/customizations'
52
52
  # @!group service
53
53
  module Aws::Glue
54
54
 
55
- GEM_VERSION = '1.168.0'
55
+ GEM_VERSION = '1.170.0'
56
56
 
57
57
  end
data/sig/client.rbs CHANGED
@@ -3709,7 +3709,9 @@ module Aws
3709
3709
  def is_registered_with_lake_formation: () -> bool
3710
3710
  def cell_filters: () -> ::Array[Types::ColumnRowFilter]
3711
3711
  def query_authorization_id: () -> ::String
3712
+ def is_multi_dialect_view: () -> bool
3712
3713
  def resource_arn: () -> ::String
3714
+ def is_protected: () -> bool
3713
3715
  def permissions: () -> ::Array[("ALL" | "SELECT" | "ALTER" | "DROP" | "DELETE" | "INSERT" | "CREATE_DATABASE" | "CREATE_TABLE" | "DATA_LOCATION_ACCESS")]
3714
3716
  end
3715
3717
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Glue/Client.html#get_unfiltered_table_metadata-instance_method
@@ -3724,6 +3726,8 @@ module Aws
3724
3726
  all_columns_requested: bool?
3725
3727
  },
3726
3728
  supported_permission_types: Array[("COLUMN_PERMISSION" | "CELL_FILTER_PERMISSION" | "NESTED_PERMISSION" | "NESTED_CELL_PERMISSION")],
3729
+ ?parent_resource_arn: ::String,
3730
+ ?root_resource_arn: ::String,
3727
3731
  ?supported_dialect: {
3728
3732
  dialect: ("REDSHIFT" | "ATHENA" | "SPARK")?,
3729
3733
  dialect_version: ::String?
data/sig/types.rbs CHANGED
@@ -3036,6 +3036,8 @@ module Aws::Glue
3036
3036
  attr_accessor name: ::String
3037
3037
  attr_accessor audit_context: Types::AuditContext
3038
3038
  attr_accessor supported_permission_types: ::Array[("COLUMN_PERMISSION" | "CELL_FILTER_PERMISSION" | "NESTED_PERMISSION" | "NESTED_CELL_PERMISSION")]
3039
+ attr_accessor parent_resource_arn: ::String
3040
+ attr_accessor root_resource_arn: ::String
3039
3041
  attr_accessor supported_dialect: Types::SupportedDialect
3040
3042
  attr_accessor permissions: ::Array[("ALL" | "SELECT" | "ALTER" | "DROP" | "DELETE" | "INSERT" | "CREATE_DATABASE" | "CREATE_TABLE" | "DATA_LOCATION_ACCESS")]
3041
3043
  attr_accessor query_session_context: Types::QuerySessionContext
@@ -3048,7 +3050,9 @@ module Aws::Glue
3048
3050
  attr_accessor is_registered_with_lake_formation: bool
3049
3051
  attr_accessor cell_filters: ::Array[Types::ColumnRowFilter]
3050
3052
  attr_accessor query_authorization_id: ::String
3053
+ attr_accessor is_multi_dialect_view: bool
3051
3054
  attr_accessor resource_arn: ::String
3055
+ attr_accessor is_protected: bool
3052
3056
  attr_accessor permissions: ::Array[("ALL" | "SELECT" | "ALTER" | "DROP" | "DELETE" | "INSERT" | "CREATE_DATABASE" | "CREATE_TABLE" | "DATA_LOCATION_ACCESS")]
3053
3057
  SENSITIVE: []
3054
3058
  end
@@ -5151,6 +5155,8 @@ module Aws::Glue
5151
5155
  attr_accessor catalog_id: ::String
5152
5156
  attr_accessor version_id: ::String
5153
5157
  attr_accessor federated_table: Types::FederatedTable
5158
+ attr_accessor view_definition: Types::ViewDefinition
5159
+ attr_accessor is_multi_dialect_view: bool
5154
5160
  SENSITIVE: []
5155
5161
  end
5156
5162
 
@@ -5728,6 +5734,23 @@ module Aws::Glue
5728
5734
  SENSITIVE: []
5729
5735
  end
5730
5736
 
5737
+ class ViewDefinition
5738
+ attr_accessor is_protected: bool
5739
+ attr_accessor definer: ::String
5740
+ attr_accessor sub_objects: ::Array[::String]
5741
+ attr_accessor representations: ::Array[Types::ViewRepresentation]
5742
+ SENSITIVE: []
5743
+ end
5744
+
5745
+ class ViewRepresentation
5746
+ attr_accessor dialect: ("REDSHIFT" | "ATHENA" | "SPARK")
5747
+ attr_accessor dialect_version: ::String
5748
+ attr_accessor view_original_text: ::String
5749
+ attr_accessor view_expanded_text: ::String
5750
+ attr_accessor is_stale: bool
5751
+ SENSITIVE: []
5752
+ end
5753
+
5731
5754
  class Workflow
5732
5755
  attr_accessor name: ::String
5733
5756
  attr_accessor description: ::String
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-glue
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.168.0
4
+ version: 1.170.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-02-05 00:00:00.000000000 Z
11
+ date: 2024-04-12 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core