[
https://issues.apache.org/jira/browse/HBASE-5619?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13239205#comment-13239205
]
[email protected] commented on HBASE-5619:
------------------------------------------------------
bq. On 2012-03-26 23:21:58, Michael Stack wrote:
bq. > src/main/proto/RegionAdmin.proto, line 21
bq. > <https://reviews.apache.org/r/4054/diff/5/?file=95915#file95915line21>
bq. >
bq. > What did we figure on the package name? Shouldn't it agree w/ the
dir that holds the .proto files at src/main? Currently one is protobuf and the
other is proto.
bq.
bq. Jimmy Xiang wrote:
bq. There is already an exiting folder called protobuf (rest). Let me
change the dir holds the .proto files under src/main to protobuf.
good
bq. On 2012-03-26 23:21:58, Michael Stack wrote:
bq. > src/main/proto/RegionAdmin.proto, line 35
bq. > <https://reviews.apache.org/r/4054/diff/5/?file=95915#file95915line35>
bq. >
bq. > What are these two booleans broken out? Aren't they in they
attributes of HRI already? Why repeat them?
bq.
bq. Jimmy Xiang wrote:
bq. I used to put these transient parameters in the protobuff RegionInfo
as well. However Todd thought it's better to put them outside.
bq.
bq. What'd do you think? To me, it is fine either way. However, if we
are going to replace HRI with the protobuff later on, it may be better to put
them together.
Hmm. Moving out these flags changes the current 'model' but in a direction we
should be headed in. The split/offline stuff were stuffed into HRI in the
first place just because this was an easy way to pass these transient states
around in hbase; they also are less important now in HRI though still depended
on when we scan meta IIRC. Its probably better to evolve toward an HRI that is
immutable once made. So I'd be down w/ moving them out but its up to you. It
might be easier on you achieving parity w/ first commit of pb work if the pb
classes are like the internals they will be feeding into.
bq. On 2012-03-26 23:21:58, Michael Stack wrote:
bq. > src/main/proto/RegionAdmin.proto, line 70
bq. > <https://reviews.apache.org/r/4054/diff/5/?file=95915#file95915line70>
bq. >
bq. > Should we be repeating the API documentation that is up in the
HRegionInterface that this .proto replaces here? If its not here, where will
it be? Not all of the javadoc should make it over -- the stuff that says
nothing shouldn't but some is of worth. What you think?
bq.
bq. Jimmy Xiang wrote:
bq. I though about this. I added documentation to RegionClient.proto.
For methods in RegionAdmin, the method names seem to be very clear. I will
take a look again and document where confusing/misunderstand could arise.
I'd be fine w/ the doc being sparse but there are a few cases where doc is
necessary; e.g. the one I cite above.
bq. On 2012-03-26 23:21:58, Michael Stack wrote:
bq. > src/main/proto/RegionAdmin.proto, line 87
bq. > <https://reviews.apache.org/r/4054/diff/5/?file=95915#file95915line87>
bq. >
bq. > Isn't the response currently a void? And isnt' flush async (IIRC).
If so, under what circumstance would we be able to fill out this response?
bq.
bq. Jimmy Xiang wrote:
bq. I was thinking to set it if the HRegion.flushCache call returned true.
It is just informational.
Does that imply a synchronous call? I thought flushCache just queued the flush
then returned to the client w/o actually waiting on flush to complete.
bq. On 2012-03-26 23:21:58, Michael Stack wrote:
bq. > src/main/proto/RegionClient.proto, line 52
bq. > <https://reviews.apache.org/r/4054/diff/5/?file=95916#file95916line52>
bq. >
bq. > This is new? Being able to do this? How will it be used?
bq.
bq. Jimmy Xiang wrote:
bq. Some call expects a region name, some call expects an encoded region
name. With a specifier, we can handle both.
bq. Encoded region name works only if the region is on-line. If we can't
find the region based on the specifier, a region not found exception will be
thrown.
bq.
bq. So we can simplify the request a little bit since we don't have to ask
for region name, and encoded region name, and check only if one is specified.
bq.
bq. I will add a comment for it.
ok
bq. On 2012-03-26 23:21:58, Michael Stack wrote:
bq. > src/main/proto/RegionClient.proto, line 66
bq. > <https://reviews.apache.org/r/4054/diff/5/?file=95916#file95916line66>
bq. >
bq. > This is new feature on get? Or just special handling of an
attribute?
bq.
bq. Jimmy Xiang wrote:
bq. This is for the exist() call. In this case, the caller doesn't care
about the result. They just want to know if the row is there. It is not
special handling of an attribute.
The current implementation actually does the fetch and in the client checks it
null or not IIRC? Or is it all serverside? So you add this to the Get so you
don't have to do the exists call? You can implement it w/ the addition to Get?
bq. On 2012-03-26 23:21:58, Michael Stack wrote:
bq. > src/main/proto/RegionClient.proto, line 71
bq. > <https://reviews.apache.org/r/4054/diff/5/?file=95916#file95916line71>
bq. >
bq. > We don't have this in the java Result. I don't understand why this
is making its way into the object.
bq.
bq. Jimmy Xiang wrote:
bq. In the multi call, they mix many requests together. However, they
don't retrieve the response in order. They retrieve the response based on the
region name.
bq. In this case, I'd like the server to return the region name. This is
optional. In most call, it is not used.
So you are doing this so you have to create less objects? So you can avoid
MultiResponse with its regionname to responses?
bq. On 2012-03-26 23:21:58, Michael Stack wrote:
bq. > src/main/proto/RegionClient.proto, line 77
bq. > <https://reviews.apache.org/r/4054/diff/5/?file=95916#file95916line77>
bq. >
bq. > what is processed?
bq.
bq. Jimmy Xiang wrote:
bq. Sometimes, for some action, for example delete, they don't care about
the result. They just want to know if the action is processed or not. This is
for this kind use case.
Needs comment
bq. On 2012-03-26 23:21:58, Michael Stack wrote:
bq. > src/main/proto/RegionClient.proto, line 82
bq. > <https://reviews.apache.org/r/4054/diff/5/?file=95916#file95916line82>
bq. >
bq. > Why we need to add a region to the Get even optionally?
bq.
bq. Jimmy Xiang wrote:
bq. That's to support multiple Get requests in one call. Each Get request
can have its own region. If all Gets are for one region, the caller can
specify the region in the request level.
I see specifying the region name in this GetRequest but not sure about why we'd
have region in the Get object itself if we are doing it here on the invocation.
Seems like the two contend?
bq. On 2012-03-26 23:21:58, Michael Stack wrote:
bq. > src/main/proto/RegionClient.proto, line 84
bq. > <https://reviews.apache.org/r/4054/diff/5/?file=95916#file95916line84>
bq. >
bq. > Why is the Get polluted by multiGet stuff?
bq.
bq. Jimmy Xiang wrote:
bq. The interface is kind of similar, but very flexible. Any problem with
that?
On 'Any problem with that?', no. Just trying to avoid redundancy that makes
the Interface imprecise and therefore hard to grok.
bq. On 2012-03-26 23:21:58, Michael Stack wrote:
bq. > src/main/proto/RegionClient.proto, line 91
bq. > <https://reviews.apache.org/r/4054/diff/5/?file=95916#file95916line91>
bq. >
bq. > I thought we could set this into the Get above? Why have it here as
separate param?
bq.
bq. Jimmy Xiang wrote:
bq. This is used as a default region. If you have multiple Gets on the
same region, you don't have to specify it every where.
Could we just have it out here as a param on the get and not in the Get object?
Will that work (I think I understand why Result needs it internal to cut down
on objects we need to support multiresponses)
bq. On 2012-03-26 23:21:58, Michael Stack wrote:
bq. > src/main/proto/RegionClient.proto, line 159
bq. > <https://reviews.apache.org/r/4054/diff/5/?file=95916#file95916line159>
bq. >
bq. > Again, does it make sense having this in here? I mean regions come
and go -- e.g. split -- so you could have reference to non-existent region.
This stuff of tying a mutation to a particular region should be done external
to the mutations themselves?
bq. >
bq. > Is this trying to do multiaction? Maybe that should be a message
apart from mutate? The new message would have region name and the mutate?
bq.
bq. Jimmy Xiang wrote:
bq. Similar to Gets, I'd like to make the interface flexible. Sounds you
prefer to have simple interface instead, right? That means we may have to have
too many methods. For java interface, it is ok and preferred to have many
methods. But for RPC, I think it is better to have fewer and flexible methods.
'But for RPC, I think it is better to have fewer and flexible methods.' Fair
enough. Would like to make it just flexible enough and no more (smile). Needs
documentation too else fellas like me will come in and get wrong impression on
whats going on.
bq. On 2012-03-26 23:21:58, Michael Stack wrote:
bq. > src/main/proto/RegionClient.proto, line 193
bq. > <https://reviews.apache.org/r/4054/diff/5/?file=95916#file95916line193>
bq. >
bq. > What is this implementing from current Delete? The delete family?
bq. >
bq. > This is returned to the client?
bq. >
bq. > How do we do a column that has no qualifier? Thats possible in
hbase.
bq.
bq. Jimmy Xiang wrote:
bq. To delete a family, you don't specify the qualifier. To delete a only
one version of a column, you sepcify the family, qualifer, timestamp, and set
oneVersion to true.
bq. To delete all version of a column, you specify the family, qualifier
bq.
bq. What do you mean a column that has no qualifier? Are you referring to
Delete.deleteColumns(family, qualifier, timestamp), and qualifer = null?
Yeah. You can put a value at row, family, null qualifier, ts. You can also
delete it (might not be a good idea but you can do it).
bq. On 2012-03-26 23:21:58, Michael Stack wrote:
bq. > src/main/proto/RegionClient.proto, line 214
bq. > <https://reviews.apache.org/r/4054/diff/5/?file=95916#file95916line214>
bq. >
bq. > Yeah, why have regionspecified in the mutate if you are going to
provide it as a param too?
bq.
bq. Jimmy Xiang wrote:
bq. The same reason as for Get. It is used as a default region in case
all/most mutates are for a same region.
Having 'default' region doesn't sound right, even if you are trying to be
flexible.
bq. On 2012-03-26 23:21:58, Michael Stack wrote:
bq. > src/main/proto/RegionClient.proto, line 233
bq. > <https://reviews.apache.org/r/4054/diff/5/?file=95916#file95916line233>
bq. >
bq. > Why this when regions can change. Also, a Scan can traverse many
regions so what is the regionspecifier referring to? The first?
bq.
bq. Jimmy Xiang wrote:
bq. Yes, it is the first region.
You know what I am going to say (smile)
bq. On 2012-03-26 23:21:58, Michael Stack wrote:
bq. > src/main/proto/RegionClient.proto, line 338
bq. > <https://reviews.apache.org/r/4054/diff/5/?file=95916#file95916line338>
bq. >
bq. > Does this belong here? You provide it as a param when making the
request.
bq.
bq. Jimmy Xiang wrote:
bq. Yes, this is for Region protocol, not client API. You need to specify
for which region this action will be executed on, right?
Yes. I got into habit of complaining about the region specs. They make sense
when they are params. Its regions internal to Get, etc., that causes me
difficulty.
bq. On 2012-03-26 23:21:58, Michael Stack wrote:
bq. > src/main/proto/RegionClient.proto, line 396
bq. > <https://reviews.apache.org/r/4054/diff/5/?file=95916#file95916line396>
bq. >
bq. > Is this everything? I don't see closestrowbefore? We'll probably
still need this in 0.96.
bq.
bq. Jimmy Xiang wrote:
bq. It is still there. It is collapsed into the Get call.
ok. good.
- Michael
-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
https://reviews.apache.org/r/4054/#review6365
-----------------------------------------------------------
On 2012-03-26 20:14:22, Jimmy Xiang wrote:
bq.
bq. -----------------------------------------------------------
bq. This is an automatically generated e-mail. To reply, visit:
bq. https://reviews.apache.org/r/4054/
bq. -----------------------------------------------------------
bq.
bq. (Updated 2012-03-26 20:14:22)
bq.
bq.
bq. Review request for hbase.
bq.
bq.
bq. Summary
bq. -------
bq.
bq. This is the first draft of the ProtoBuff HRegionProtocol. The
corresponding java vs pb method mapping is attached to the jira:
https://issues.apache.org/jira/browse/HBASE-5443
bq.
bq. Please review. I'd like to move ahead after we get to some agreement.
bq.
bq.
bq. This addresses bug HBASE-5619.
bq. https://issues.apache.org/jira/browse/HBASE-5619
bq.
bq.
bq. Diffs
bq. -----
bq.
bq. pom.xml 10b13ef
bq. src/main/proto/RegionAdmin.proto PRE-CREATION
bq. src/main/proto/RegionClient.proto PRE-CREATION
bq. src/main/proto/hbase.proto PRE-CREATION
bq.
bq. Diff: https://reviews.apache.org/r/4054/diff
bq.
bq.
bq. Testing
bq. -------
bq.
bq.
bq. Thanks,
bq.
bq. Jimmy
bq.
bq.
> Create PB protocols for HRegionInterface
> ----------------------------------------
>
> Key: HBASE-5619
> URL: https://issues.apache.org/jira/browse/HBASE-5619
> Project: HBase
> Issue Type: Sub-task
> Components: ipc, master, migration, regionserver
> Reporter: Jimmy Xiang
> Assignee: Jimmy Xiang
> Fix For: 0.96.0
>
> Attachments: hbase-5619.patch, hbase-5619_v3.patch
>
>
> Subtask of HBase-5443, separate HRegionInterface into admin protocol and
> client protocol, create the PB protocol buffer files
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
