def METHOD_NAME(database: Optional[str] = None,
                            instance: Optional[str] = None,
                            project: Optional[str] = None,
                            opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetDatabaseIamPolicyResult:
    """
    Retrieves the current IAM policy data for a Spanner database.
    ## example
    ```python
    import pulumi
    import pulumi_gcp as gcp
    foo = gcp.spanner.get_database_iam_policy(project=google_spanner_database["database"]["project"],
        database=google_spanner_database["database"]["name"],
        instance=google_spanner_database["database"]["instance"])
    ```
    :param str database: The name of the Spanner database.
    :param str instance: The name of the Spanner instance the database belongs to.
    :param str project: The ID of the project in which the resource belongs. If it
           is not provided, the provider project is used.
    """
    __args__ = dict()
    __args__['database'] = database
    __args__['instance'] = instance
    __args__['project'] = project
    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
    __ret__ = pulumi.runtime.invoke('gcp:spanner/getDatabaseIamPolicy:getDatabaseIamPolicy', __args__, opts=opts, typ=GetDatabaseIamPolicyResult).value
    return AwaitableGetDatabaseIamPolicyResult(
        database=pulumi.get(__ret__, 'database'),
        etag=pulumi.get(__ret__, 'etag'),
        id=pulumi.get(__ret__, 'id'),
        instance=pulumi.get(__ret__, 'instance'),
        policy_data=pulumi.get(__ret__, 'policy_data'),
        project=pulumi.get(__ret__, 'project'))