aws-sdk-glue 1.169.0 → 1.171.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 6ea91f2ebbbdac9e0b3cb3143b659311ae3cff9d7c141c292d57a6dc12b0d808
4
- data.tar.gz: 6739829c9a011811b6ee5556527c55d0550a63c742b1c69cf9afa1225c2b4914
3
+ metadata.gz: 94f7fce50a8ebf0798baf21c67ed4f6c26d61a51703feb4b575f2a2edb5f3900
4
+ data.tar.gz: f55d99a2d34db183a588e3f555f5a3019d9a4222adad32db215c43923bc4663f
5
5
  SHA512:
6
- metadata.gz: 3dfb262f466b36b57c4caf8b05acb48afbb564689deeb1f90a248bd202fdd164fd7f44fcf8797c7897117d26729ab66f1c43a36199043b66a5763e9db4bacb4a
7
- data.tar.gz: 553eb5698719bdae71113afd982d9add5fc4f896df188081d8d151cd880d130d63e03180a39a8399b008620ae7ca17f12f9ed8a99da1ba07a748ead8a6c2beb9
6
+ metadata.gz: ae621e9c38d53ca2685cd0a9bcdaac261b6cbf4021e3ed9b902e719ea7d45f252f44e8082bb9c3dc8c16a4091da336b91d361ed34035164f5f7a605c7f3c7e39
7
+ data.tar.gz: 71fbed515f5e4991afce52946613e4d219c23c443b33fb31138b75b5c1184fb793a2005d5258419279edcc690ea422ab048ea060520b907c849eda0268014f38
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.171.0 (2024-04-19)
5
+ ------------------
6
+
7
+ * Feature - Adding RowFilter in the response for GetUnfilteredTableMetadata API
8
+
9
+ 1.170.0 (2024-04-12)
10
+ ------------------
11
+
12
+ * Feature - Modifying request for GetUnfilteredTableMetadata for view-related fields.
13
+
4
14
  1.169.0 (2024-04-02)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.169.0
1
+ 1.171.0
@@ -11801,8 +11801,8 @@ module Aws::Glue
11801
11801
  req.send_request(options)
11802
11802
  end
11803
11803
 
11804
- # Retrieves table metadata from the Data Catalog that contains
11805
- # unfiltered metadata.
11804
+ # Allows a third-party analytical engine to retrieve unfiltered table
11805
+ # metadata from the Data Catalog.
11806
11806
  #
11807
11807
  # For IAM authorization, the public IAM action associated with this API
11808
11808
  # is `glue:GetTable`.
@@ -11825,7 +11825,46 @@ module Aws::Glue
11825
11825
  # A structure containing Lake Formation audit context information.
11826
11826
  #
11827
11827
  # @option params [required, Array<String>] :supported_permission_types
11828
- # (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.
11829
11868
  #
11830
11869
  # @option params [Types::SupportedDialect] :supported_dialect
11831
11870
  # A structure specifying the dialect and dialect version used by the
@@ -11852,6 +11891,7 @@ module Aws::Glue
11852
11891
  # * {Types::GetUnfilteredTableMetadataResponse#resource_arn #resource_arn} => String
11853
11892
  # * {Types::GetUnfilteredTableMetadataResponse#is_protected #is_protected} => Boolean
11854
11893
  # * {Types::GetUnfilteredTableMetadataResponse#permissions #permissions} => Array&lt;String&gt;
11894
+ # * {Types::GetUnfilteredTableMetadataResponse#row_filter #row_filter} => String
11855
11895
  #
11856
11896
  # @example Request syntax with placeholder values
11857
11897
  #
@@ -11866,6 +11906,8 @@ module Aws::Glue
11866
11906
  # all_columns_requested: false,
11867
11907
  # },
11868
11908
  # supported_permission_types: ["COLUMN_PERMISSION"], # required, accepts COLUMN_PERMISSION, CELL_FILTER_PERMISSION, NESTED_PERMISSION, NESTED_CELL_PERMISSION
11909
+ # parent_resource_arn: "ArnString",
11910
+ # root_resource_arn: "ArnString",
11869
11911
  # supported_dialect: {
11870
11912
  # dialect: "REDSHIFT", # accepts REDSHIFT, ATHENA, SPARK
11871
11913
  # dialect_version: "ViewDialectVersionString",
@@ -11974,6 +12016,7 @@ module Aws::Glue
11974
12016
  # resp.is_protected #=> Boolean
11975
12017
  # resp.permissions #=> Array
11976
12018
  # resp.permissions[0] #=> String, one of "ALL", "SELECT", "ALTER", "DROP", "DELETE", "INSERT", "CREATE_DATABASE", "CREATE_TABLE", "DATA_LOCATION_ACCESS"
12019
+ # resp.row_filter #=> String
11977
12020
  #
11978
12021
  # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/GetUnfilteredTableMetadata AWS API Documentation
11979
12022
  #
@@ -17078,7 +17121,7 @@ module Aws::Glue
17078
17121
  params: params,
17079
17122
  config: config)
17080
17123
  context[:gem_name] = 'aws-sdk-glue'
17081
- context[:gem_version] = '1.169.0'
17124
+ context[:gem_version] = '1.171.0'
17082
17125
  Seahorse::Client::Request.new(handlers, context)
17083
17126
  end
17084
17127
 
@@ -3675,6 +3675,8 @@ module Aws::Glue
3675
3675
  GetUnfilteredTableMetadataRequest.add_member(:name, Shapes::ShapeRef.new(shape: NameString, required: true, location_name: "Name"))
3676
3676
  GetUnfilteredTableMetadataRequest.add_member(:audit_context, Shapes::ShapeRef.new(shape: AuditContext, location_name: "AuditContext"))
3677
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"))
3678
3680
  GetUnfilteredTableMetadataRequest.add_member(:supported_dialect, Shapes::ShapeRef.new(shape: SupportedDialect, location_name: "SupportedDialect"))
3679
3681
  GetUnfilteredTableMetadataRequest.add_member(:permissions, Shapes::ShapeRef.new(shape: PermissionList, location_name: "Permissions"))
3680
3682
  GetUnfilteredTableMetadataRequest.add_member(:query_session_context, Shapes::ShapeRef.new(shape: QuerySessionContext, location_name: "QuerySessionContext"))
@@ -3689,6 +3691,7 @@ module Aws::Glue
3689
3691
  GetUnfilteredTableMetadataResponse.add_member(:resource_arn, Shapes::ShapeRef.new(shape: ArnString, location_name: "ResourceArn"))
3690
3692
  GetUnfilteredTableMetadataResponse.add_member(:is_protected, Shapes::ShapeRef.new(shape: Boolean, location_name: "IsProtected"))
3691
3693
  GetUnfilteredTableMetadataResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: PermissionList, location_name: "Permissions"))
3694
+ GetUnfilteredTableMetadataResponse.add_member(:row_filter, Shapes::ShapeRef.new(shape: PredicateString, location_name: "RowFilter"))
3692
3695
  GetUnfilteredTableMetadataResponse.struct_class = Types::GetUnfilteredTableMetadataResponse
3693
3696
 
3694
3697
  GetUserDefinedFunctionRequest.add_member(:catalog_id, Shapes::ShapeRef.new(shape: CatalogIdString, location_name: "CatalogId"))
@@ -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)
@@ -12183,6 +12227,13 @@ module Aws::Glue
12183
12227
  # to authorize the call when no view context is found.
12184
12228
  # @return [Array<String>]
12185
12229
  #
12230
+ # @!attribute [rw] row_filter
12231
+ # The filter that applies to the table. For example when applying the
12232
+ # filter in SQL, it would go in the `WHERE` clause and can be
12233
+ # evaluated by using an `AND` operator with any other predicates
12234
+ # applied by the user querying the table.
12235
+ # @return [String]
12236
+ #
12186
12237
  # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/GetUnfilteredTableMetadataResponse AWS API Documentation
12187
12238
  #
12188
12239
  class GetUnfilteredTableMetadataResponse < Struct.new(
@@ -12194,7 +12245,8 @@ module Aws::Glue
12194
12245
  :is_multi_dialect_view,
12195
12246
  :resource_arn,
12196
12247
  :is_protected,
12197
- :permissions)
12248
+ :permissions,
12249
+ :row_filter)
12198
12250
  SENSITIVE = []
12199
12251
  include Aws::Structure
12200
12252
  end
@@ -14366,14 +14418,19 @@ module Aws::Glue
14366
14418
  # @return [String]
14367
14419
  #
14368
14420
  # @!attribute [rw] max_fetch_time_in_ms
14369
- # The maximum time spent in the job executor to fetch a record from
14370
- # the Kinesis data stream per shard, specified in milliseconds (ms).
14371
- # The default value is `1000`.
14421
+ # The maximum time spent for the job executor to read records for the
14422
+ # current batch from the Kinesis data stream, specified in
14423
+ # milliseconds (ms). Multiple `GetRecords` API calls may be made
14424
+ # within this time. The default value is `1000`.
14372
14425
  # @return [Integer]
14373
14426
  #
14374
14427
  # @!attribute [rw] max_fetch_records_per_shard
14375
14428
  # The maximum number of records to fetch per shard in the Kinesis data
14376
- # stream. The default value is `100000`.
14429
+ # stream per microbatch. Note: The client can exceed this limit if the
14430
+ # streaming job has already read extra records from Kinesis (in the
14431
+ # same get-records call). If `MaxFetchRecordsPerShard` needs to be
14432
+ # strict then it needs to be a multiple of `MaxRecordPerRead`. The
14433
+ # default value is `100000`.
14377
14434
  # @return [Integer]
14378
14435
  #
14379
14436
  # @!attribute [rw] max_record_per_read
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.169.0'
55
+ GEM_VERSION = '1.171.0'
56
56
 
57
57
  end
data/sig/client.rbs CHANGED
@@ -3713,6 +3713,7 @@ module Aws
3713
3713
  def resource_arn: () -> ::String
3714
3714
  def is_protected: () -> bool
3715
3715
  def permissions: () -> ::Array[("ALL" | "SELECT" | "ALTER" | "DROP" | "DELETE" | "INSERT" | "CREATE_DATABASE" | "CREATE_TABLE" | "DATA_LOCATION_ACCESS")]
3716
+ def row_filter: () -> ::String
3716
3717
  end
3717
3718
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Glue/Client.html#get_unfiltered_table_metadata-instance_method
3718
3719
  def get_unfiltered_table_metadata: (
@@ -3726,6 +3727,8 @@ module Aws
3726
3727
  all_columns_requested: bool?
3727
3728
  },
3728
3729
  supported_permission_types: Array[("COLUMN_PERMISSION" | "CELL_FILTER_PERMISSION" | "NESTED_PERMISSION" | "NESTED_CELL_PERMISSION")],
3730
+ ?parent_resource_arn: ::String,
3731
+ ?root_resource_arn: ::String,
3729
3732
  ?supported_dialect: {
3730
3733
  dialect: ("REDSHIFT" | "ATHENA" | "SPARK")?,
3731
3734
  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
@@ -3052,6 +3054,7 @@ module Aws::Glue
3052
3054
  attr_accessor resource_arn: ::String
3053
3055
  attr_accessor is_protected: bool
3054
3056
  attr_accessor permissions: ::Array[("ALL" | "SELECT" | "ALTER" | "DROP" | "DELETE" | "INSERT" | "CREATE_DATABASE" | "CREATE_TABLE" | "DATA_LOCATION_ACCESS")]
3057
+ attr_accessor row_filter: ::String
3055
3058
  SENSITIVE: []
3056
3059
  end
3057
3060
 
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.169.0
4
+ version: 1.171.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-04-02 00:00:00.000000000 Z
11
+ date: 2024-04-19 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core